テンプレート:Str mid

提供：Shirakaba.link
ナビゲーションに移動 検索に移動
テンプレートの解説[表示] [編集] [履歴] [キャッシュを破棄]

Usage

Characters in the source string are counted: the first is index <syntaxhighlight lang="text" class="" id="" style="" inline="1">1</syntaxhighlight>, the last one is index <syntaxhighlight lang="text" class="" id="" style="" inline="1">length of string</syntaxhighlight>. 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 find0}} 文字列Aに含まれる文字列Bの位置を返す。1文字目の位置は0として扱われる。
{{Isnumeric}} 文字列が数字の場合はその数字を、それ以外の場合は空白を返す。
{{str letter}} 文字列の先頭にあるアルファベットの数を返す。
{{str number}} 文字列の先頭にある数字キャラクタの数を返す。
 
モジュール、マジックワード、パーサー関数
この解説は、テンプレート:Str mid/docから呼び出されています。 (編集 | 履歴)
編集者は、このテンプレートをサンドボックス (作成 | 複製)とテストケース (作成)で試すことができます。（解説）
/docのサブページにカテゴリを追加してください。 このテンプレートのサブページ一覧。
「http://shirakaba.link/core/index.php?title=テンプレート:Str_mid&oldid=69967」から取得