replace_strings()

すべての文字列の一致を指定した文字列に置き換えます。

個々の文字列を置き換えるには、「 replace_string()」を参照してください。

構文

replace_strings(テキスト,参照,書き換え)

構文規則について詳しく知る。

パラメーター

名前	型	必須	説明
text	string	✔️	ソース文字列。
参照	dynamic	✔️	参照文字列を含む配列。 文字列ではない配列要素は無視されます。
書き換え	dynamic	✔️	書き換えを含む配列。 文字列ではない配列要素は無視されます (置換は行われません)。

戻り値

検索のすべての一致を書き換えの評価に置き換えた後、テキストを返します。 一致が重複することはありません。

例

簡単な置換

クエリを実行する

print Message="A magic trick can turn a cat into a dog"
| extend Outcome = replace_strings(
        Message,
        dynamic(['cat', 'dog']), // Lookup strings
        dynamic(['dog', 'pigeon']) // Replacements
        )

Message	結果
魔法のトリックは猫を犬に変えることができます	魔法のトリックは、ハトに犬を回すことができます

空の文字列に置き換え

空の文字列に置き換えた場合、一致する文字列が削除されます。

クエリを実行する

print Message="A magic trick can turn a cat into a dog"
| extend Outcome = replace_strings(
        Message,
        dynamic(['turn', ' into a dog']), // Lookup strings
        dynamic(['disappear', '']) // Replacements
        )

Message	結果
魔法のトリックは猫を犬に変えることができます	魔法のトリックは猫を消すことができます

置換順序

一致要素の順序が重要です。以前の一致が優先されます。 Outcome1 と Outcome2 の違いに注意してください。 ThisThwas

クエリを実行する

 print Message="This is an example of using replace_strings()"
| extend Outcome1 = replace_strings(
        Message,
        dynamic(['This', 'is']), // Lookup strings
        dynamic(['This', 'was']) // Replacements
        ),
        Outcome2 = replace_strings(
        Message,
        dynamic(['is', 'This']), // Lookup strings
        dynamic(['was', 'This']) // Replacements
        )

Message	Outcome1	Outcome2
これは、replace_strings() を使用する例です	これは、replace_strings() を使用した例です	Thwas は、replace_strings() を使用する例でした

文字列以外の置換

文字列ではない要素の置換は置き換えられず、元の文字列は保持されます。 一致は引き続き有効と見なされ、一致した文字列に対して他の置換が実行されません。 次の例では、'This' は数値 12345に置き換えられず、'is' との一致の可能性の影響を受けない出力に残ります。

クエリを実行する

 print Message="This is an example of using replace_strings()"
| extend Outcome = replace_strings(
        Message,
        dynamic(['This', 'is']), // Lookup strings
        dynamic([12345, 'was']) // Replacements
        )

Message	結果
これは、replace_strings() を使用する例です	これは、replace_strings() を使用した例です

関連コンテンツ

• 1 つの文字列の置換については、「 replace_string()」を参照してください。
• 正規表現に基づく置換については、「 replace_regex()」を参照してください。
• 文字のセットを置換する方法については、「translate ()」を参照してください。