変換フォーマッタ
Version 25.3.9411
Version 25.3.9411
- concat([newString])
- insert(integer_index, string)
- lsplit(delimiter, integer_index)
- regexreplace(pattern, newvalue[, startindex])
- remove(integer_index[, integer_count])
- replace(oldvalue, newvalue[, ishex])
- rsplit(delimiter, integer_index)
- split(delimiter, indextoreturn)
- striphtml()
- substring(index[, length])
- toalpha()
- toalphanum()
- truncate(integer_count)
変換フォーマッタ
concat([newString])
フォーマッタにパイプされた値と、フォーマッタに渡されたパラメータを連結します。
- newString:文字列に追加する属性。
insert(integer_index, string)
指定したインデックスに指定した文字列を挿入します。
- index:新しい文字列が挿入される元の値の位置のゼロベースのインデックス。
- string:元の値に挿入する文字列。
lsplit(delimiter, integer_index)
属性値で表される文字列を、最初のパラメータで区切られたトークンに分割し、2番目のパラメータで指定されたインデックスのトークンを返します。左から数えます。
- delimiter:文字列をトークンに分割するための区切り文字として使用される文字列。
- index:最初のトークンがインデックス
1にある場合にリクエストされるトークンのインデックス。
regexreplace(pattern, newvalue[, startindex])
pattern で指定された正規表現パターンを入力文字列内で検索し、各出現箇所を newvalue で置き換えます。
startindex パラメータが指定されている場合、検索は文字列内のこの位置から開始されます(つまり、フォーマッタは startindex より前に発生する pattern のインスタンスを無視します)。
例
<api:set attr="myString" value="The cost of the item is $12.98." />
<api:set attr="decimalPattern" value="\[0-9\]+\.?\[0-9\]*" />
<api:set attr="updatedListing" value="[myString | regexreplace([decimalPattern],'10.99')]" />
<!-- updatedListing has the value: The cost of the item is $10.99 -->
remove(integer_index[, integer_count])
属性値から文字を削除します。最初のパラメータで指定された0オリジンのインデックスから始めます。
- index:文字の削除を開始する位置。
- count:削除する文字数(オプション)。指定しない場合は、指定されたインデックスから始まるすべての文字が削除されます。
replace(oldvalue, newvalue[, ishex])
oldvalue の各出現箇所を入力文字列内で検索し、削除して newvalue で置き換えます。
ishex パラメータは、 oldvalue パラメータが置換する文字の16進数表記かどうかを示します(デフォルトはfalse です)。
例
<api:set attr="myString" value="I hope you have a wonderful day." />
<api:set attr="honestString" value="[myString | replace('you', 'I')]" />
<!-- honestString holds the value: I hope I have a wonderful day. -->
rsplit(delimiter, integer_index)
属性値で表される文字列を、最初のパラメータで区切られたトークンに分割し、2番目のパラメータで指定されたインデックスのトークンを返します。右から数えます。
- delimiter:文字列をトークンに分割するための区切り文字として使用される文字列。
- index:最初のトークンがインデックス1にある場合にリクエストされるトークンのインデックス。
split(delimiter, indextoreturn)
入力文字列を delimiter の各出現箇所で部分文字列のセットに分割し、指定された index の文字列を返します。
indextoreturn が指定されている場合、部分文字列のセットはインデックス付けされ、そのうちの1つが返されます(例えば、 indextoreturn として1 を渡すと、分割結果の最初の部分文字列を返します)。
例
<api:set attr="myName" value="Walter White" />
<api:set attr="firstName" value="[myName | split(' ',1)]" />
<!-- firstName contains the value: Walter -->
striphtml()
HTML マークアップが削除された文字列を返します。
substring(index[, length])
入力文字列値の、 index 値から始まり length 文字後の部分文字列を返します。length が指定されていない場合、部分文字列は元の文字列の末尾で終了します。
例
<!-- parse out the characters before the first comma, combining substring() with find() -->
<api:set attr="myString" value="Luke, I am your father". />
<api:set attr="commaPosition" value="[myString | find(',')]" />
<api:set attr="introClause" value="[myString | substring(0, [commaPosition])]" />
<!-- introClause has the value: Luke -->
toalpha()
文字列内の文字のみを返します。
toalphanum()
文字列内の英数字のみを返します。
truncate(integer_count)
属性値を、パラメータで指定された文字数に切り捨てます。
- count:結果の文字列の文字数。