コンテンツにスキップ

Template:Str mid

半永久的に拡張半保護されているテンプレート
テンプレートの解説[表示] [編集] [履歴] [キャッシュを破棄]

Usage

Characters in the source string are counted: the first is index 1, the last one is index length of string. The substring requested can be defined by these two indexes. Also, the substring can be defined by one index, and the substring length. The options are: {{str mid|<string>|<index of first character>|<length of substring>|<index of last character>}} It returns a part of the <string>, starting with character on position index, length <sublength>, last character returned is end index.

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|5|3}} → efg

If parameter 2 is omitted, start is from character 1:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz||5}} → Abcde

If parameter 3 is omitted, the whole rest of the string is returned:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|15}} → opqrstuvwxyz

Counting from the end

By entering a negative value, the index is counted from the end:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|-7|4}} → tuvw
  • {{str mid|Abcdefghijklmnopqrstuvwxyz|-7}} → tuvwxyz

Instead if substring length, use index for last character

By using parameter |4=n, a number, you do not ask for substring length, but the last character (as counted from the start of the input string):

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|5||7}} → efg

Spaces are kept

In the returned substring, spaces are kept:

  • >{{str mid|I like this.|2|6}}< → >like<

But the input string is trimmed:

  • >{{str mid| I like this. |2|6}}< → >like<

Error messages

When the ranges (either param2 or the substring length) is out impossible in the string, an error is returned:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|30}} → モジュールStringのエラー: String subset index out of range
  • {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45}} → efghijklmnopqrstuvwxyz

The error can be suppressed by using |ignore errors=true. A blank (empty string) will be returned:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45|ignore errors=true}} → efghijklmnopqrstuvwxyz

Error category

  • |no category=true switches off category adding.
  • |error category=[[Category:Your category name]] sets the category to be added when in case of an error.
Default is Category:Errors reported by Module String.

See also

文字列処理テンプレート
 
文字列のトリミング（英語版）
長さ別
{{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:Str mid/docから呼び出されています。 (編集 | 履歴)
編集者は、このテンプレートをサンドボックス (編集 | 差分)とテストケース (編集)で試すことができます。（解説）
/docのサブページにカテゴリを追加してください。 このテンプレートのサブページ一覧。
「https://ja.wikipedia.org/w/index.php?title=Template:Str_mid&oldid=86501284」から取得