@ReplaceSubstring (式言語)

文字列内の特定の単語や語句を、指定する単語や語句に置換します。大文字と小文字は区別します。

構文

@ReplaceSubstring( sourceList ; fromList ; toList )

パラメータ

sourceList

文字列または文字列リスト。内容を変更する対象文字列を指定します。

fromList

文字列または文字列リスト。置換する単語または語句が含まれているリストを指定します。

toList

文字列または文字列リスト。置換後の単語または語句が含まれているリストを指定します。

戻り値

newSourceList

文字列または文字列リスト。sourceList の中の fromList の値を toList の対応する値に置換したものが返されます。fromList のどの値も sourceList の値と一致しないときは、sourceList が変更されずにそのまま返されます。

使用法

fromList で指定した文字列の数が toList よりも多い場合は、fromList の残りの文字列は toList の最後の文字列に置換されます。toList の文字列のほうが多い場合は、残りは無視されます。一致する文字列がない場合は、sourceList が変更されずにそのまま返されます。

fromList にリストを指定した場合は、まず最初のリストアイテムの置換が行われ、その結果の sourceList に対して以降の検索が行われます。

以下に例を示します。

@ReplaceSubstring("first";"first":"second";"second":"third")

この例では、third が返されます。

まず、fromList の最初のリストアイテムの「first」が「second」に置換されます。この結果、sourceList の内容は「second」になっています。次に、fromList の 2 番目のリストアイテムの「second」が「third」に置換されます。

ヒント: @ReplaceSubString を使用して改行を文字列から削除するには、改行を " " または "" に置換します。

例

次の例では、「I hate apples」が返されます。
```
@ReplaceSubstring( "I like apples" ; "like" ; "hate" )
```

次の例では、「I hate peaches」が返されます。

@ReplaceSubstring( "I like apples" ; "like" : "apples" ; "hate" : "peaches")

次の例では、[Description] フィールドの文字列にある改行がすべて空白に置換されます。
```
@ReplaceSubString(Description;@Newline;" ")
```

クロスリファレンス

LotusScript® 言語の Replace 関数