変換フォーマッタ

Version 25.3.9411


変換フォーマッタ


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:結果の文字列の文字数。