モジュール:String/doc

This is the documentation page for モジュール:String

文字列を扱ういくつかの関数を提供するモジュールです。UTF-8でエンコードされた文字列を取り扱えます。

このモジュールのユニットテストについてはモジュール:String/testcasesをご参照ください。

共通引数

引数の一覧
引数 内容 既定値 説明
ignore_errors エラー無視 なし
false, no, 0, 空文字
エラーがあるときはそのままエラーを返す
true、1など上記以外の文字列
エラーがあってもエラーを返さず空文字を返す
error_category エラーカテゴリ Category:モジュールStringのエラー エラーがあるときのCategory:追跡カテゴリ名を指定する
no_category カテゴリ付与 なし
false, no, 0, 空文字
エラーがあるときにエラーカテゴリを付与する
true、1など上記以外の文字列
エラーがあってもエラーカテゴリを付与しない

使い方

len

文字列の長さを返します。

{{#invoke:String|len|文字列}}

もしくは

{{#invoke:String|len|s=文字列}}
引数の一覧
引数 内容 既定値 説明
s 文字列 なし 対象の文字列

例:

  • {{#invoke:String|len| abcdefghi }} → 11
  • {{#invoke:String|len|s= abcdefghi }} → 9

sub

文字列から指定された部分の文字列を抜き出して返します。

{{#invoke:String|sub|文字列|開始位置|終了位置}}

もしくは

{{#invoke:String|sub|s=文字列|i=開始位置|j=終了位置}}
引数の一覧
引数 内容 既定値 説明
s 文字列 なし 元の文字列
i 開始位置 1 抜き出す初めの文字の位置
j 終了位置 -1 抜き出す最後の文字の位置

開始位置・終了位置には負の数を指定することも可能です。その場合、文字列の後ろから数えます。例えば、「-1」は文字列の最後の文字です。

文字の位置が範囲外の場合、エラーになります。

例:

  • "{{#invoke:String|sub| abcdefghi }}" → " abcdefghi "
  • "{{#invoke:String|sub|s= abcdefghi }}" → "abcdefghi"
  • "{{#invoke:String|sub| abcdefghi | 3 }}" → "bcdefghi "
  • "{{#invoke:String|sub|s= abcdefghi |i= 3 }}" → "cdefghi"
  • "{{#invoke:String|sub| abcdefghi | 3 | 4 }}" → "bc"
  • "{{#invoke:String|sub|s= abcdefghi |i= 3 |j= 4 }}" → "cd"

sublength

この関数は{{Str sub}}を実装しており、Str subのような古いテンプレートを維持するために残されています。文字列から指定された部分の文字列を抜き出して返します。

{{#invoke:String|sublength|s=文字列|i=開始位置|len=長さ}}
引数の一覧
引数 内容 既定値 説明
s 文字列 なし 元の文字列
i 開始位置 1 抜き出す初めの文字の位置。1文字目は"0"を指定します
len 長さ 元の文字列の長さ 抜き出す文字列の長さ

例:

  • {{#invoke:String|sublength|s= abcdefghi }} → abcdefghi
  • {{#invoke:String|sublength|s= abcdefghi |i= 3 }} → defghi
  • {{#invoke:String|sublength|s= abcdefghi |i= 3 |len= 4 }} → defg

match

パターンに一致する文字列を返します。

{{#invoke:String|match|文字列|パターン|検索開始位置|一致番号|プレーンフラグ|エラー出力}}

もしくは

{{#invoke:String|match
|s=文字列
|pattern=パターン
|start=検索開始位置
|match=一致番号
|plain=プレーンフラグ
|nomatch=エラー出力
}}
引数の一覧
引数 内容 既定値 説明
s 文字列 なし 検索対象の文字列
pattern パターン なし 検索する文字列パターン
start 検索開始位置 1 検索を開始する文字の位置
match 一致番号 1 検索開始位置から何番目の一致箇所を返すか
plain プレーンフラグ false
false, no, 0, 空文字
パターンをLuaパターンとして解釈する
true、1など上記以外の文字列
パターンをプレーンテキストとして解釈する
nomatch エラー出力 なし 何もマッチしなかったときに返す文字列
何も指定しないとエラーを返す(既定)

検索開始位置・一致番号には負の数を指定することも可能です。その場合、後ろから数えます。

パターンにキャプチャがある場合はそのキャプチャを返します。

matchかstart引数が範囲外の場合、エラーを返します。パターンが見つからなかった場合はnomatchを指定していなければエラーを返します。また、ignore_errors=trueを指定した場合、いずれのエラーも返さず、代わりに空の文字列を返します。

Luaパターンの詳細はScribunto patternsScribunto Unicode string patternsをご参照ください。

例:

  • {{#invoke:String|match| abc123def456 |%d+}} → 123
  • {{#invoke:String|match|s= abc123def456 |pattern= %d+ }} → 123
  • {{#invoke:String|match| abc123def456 |%d+|6}} → 23
  • {{#invoke:String|match|s= abc123def456 |pattern= %d+ |start= 6 }} → 3
  • {{#invoke:String|match|s= abc123def456 |pattern= %d+ |start= 6 |match= 2 }} → 456
  • {{#invoke:String|match|s= abc123%d+ |pattern= %d+ }} → 123
  • {{#invoke:String|match|s= abc123%d+ |pattern= %d+ |plain= true }} → %d+
  • {{#invoke:String|match|s= abc |pattern= %d }}モジュールStringのエラー: Match not found
  • {{#invoke:String|match|s= abc |pattern= %d |nomatch= No numeric characters in string }} → No numeric characters in string

pos

文字列の中から指定された位置にある文字を返します。

{{#invoke:String|pos|文字列|位置}}

もしくは

{{#invoke:String|pos|target=文字列|pos=位置}}
引数の一覧
引数 内容 既定値 説明
target 文字列 なし 検索対象の文字列
pos 位置 なし 返す文字の位置

位置には負の数を指定することも可能です。その場合、文字列の後ろから数えます。例えば、「-1」は文字列の最後の文字です。

posが0または文字列の長さより大きい場合、エラーを返します。

例:

  • {{#invoke:String|pos| abcdefghi | 4 }} → c
  • {{#invoke:String|pos|target= abcdefghi |pos= 4 }} → d

str_find

この関数は{{Str find}}を実装します。この関数が提供されるのは既存のテンプレートを維持するためであり、新しいコードやテンプレートには推奨されません。新しいコードには代わりにfind関数を使用してください。"source"の文字列の中から"target"のパターンを検索し、その位置を返します。パターンが見つからない場合は-1を返します。

なお、"target"の文字列が空白か指定されていない場合、1を返します。これは一般的とは言えない挙動であり、特別に扱う必要があります。

{{#invoke:String|str_find|文字列|パターン}}

もしくは

{{#invoke:String|str_find|source=文字列|target=パターン}}

例:

  • {{#invoke:String|str_find| abc123def }} → 1
  • {{#invoke:String|str_find|source= abc123def }} → 1
  • {{#invoke:String|str_find| abc123def |123}} → 5
  • {{#invoke:String|str_find|source= abc123def |target= 123 }} → 4

find

文字列の中からパターンを検索しその位置を返します。

{{#invoke:String|find|文字列|パターン|検索開始位置|プレーンフラグ}}

もしくは

{{#invoke:String|find
|source=文字列
|target=パターン
|start=検索開始位置
|plain=プレーンフラグ
}}
引数の一覧
引数 内容 既定値 説明
source 文字列 なし 検索対象の文字列
target パターン なし 検索する文字列パターン
start 検索開始位置 1 検索を開始する文字の位置
plain プレーンフラグ true
false, no, 0, 空文字
パターンをLuaパターンとして解釈する
trueなど上記以外の文字列
パターンをプレーンテキストとして解釈する

最初の文字の位置は1としています。文字列・パターンが指定されていなかったり、もしくは文字列の中にパターンがなかった場合は、0を返します。この関数はUTF-8の文字列にも使えます。

例:

  • {{#invoke:String|find| abc123def }} → 0
  • {{#invoke:String|find|source= abc123def }} → 0
  • {{#invoke:String|find| abc123def |123}} → 5
  • {{#invoke:String|find|source= abc123def |target= 123 }} → 4
  • {{#invoke:String|find| abc123def |%d|3|false}} → 5
  • {{#invoke:String|find|source= abc123def |target= %d |start= 3 |plain= false }} → 4

replace

パターンと一致する部分を別の文字列で置き換えます。

{{#invoke:String|replace|文字列|パターン|置換文字列|置換回数|プレーンフラグ}}

もしくは

{{#invoke:String|replace
|source=文字列
|pattern=パターン
|replace=置換文字列
|count=置換回数
|plain=プレーンフラグ
}}
引数の一覧
引数 内容 既定値 説明
source 文字列 なし 対象の文字列
pattern パターン なし 置換される文字列パターン
replace 置換文字列 なし 置換する文字列
何も指定しないとパターンを削除する(既定)
count 置換回数 なし 置換する回数
何も指定しないと可能な箇所すべてを置換する(既定)
plain プレーンフラグ true
false, no, 0, 空文字
パターンをLuaパターンとして解釈する
trueなど上記以外の文字列
パターンをプレーンテキストとして解釈する

例:

  • "{{#invoke:String|replace| abc123def456 |123|N}}" → " abcNdef456 "
  • "{{#invoke:String|replace|source= abc123def456 |pattern= 123 |replace= N }}" → "abcNdef456"
  • "{{#invoke:String|replace| abc123def456 |%d+|N|1|false}}" → " abcNdef456 "
  • "{{#invoke:String|replace|source= abc123def456 |pattern= %d+ |replace= N |count=1 |plain= false }}" → "abcNdef456"
  • "{{#invoke:String|replace|source= abc123def456 |pattern= %d+ |replace= N |plain= false }}" → "abcNdefN"

rep

Luaのstring.repをテンプレートにも使えるようにするための関数であり、文字列を指定回数返します。

{{#invoke:String|rep|文字列|繰り返し回数}}
引数の一覧
引数 内容 既定値 説明
source 文字列 なし 対象の文字列
count 繰り返し回数 なし 対象の文字列を繰り返す回数

例:

  • "{{#invoke:String|rep|hello|3}}" → "hellohellohello"
  • "{{#invoke:String|rep| hello | 3 }}" → " hello hello hello "

関連項目