replace_strings()

  • 项目

将所有字符串匹配项替换为指定字符串。

若要替换单个字符串，请参阅 replace_string()。

语法

replace_strings(text,lookups,rewrites)

详细了解语法约定。

参数

客户 类型​​ 必需 说明
text string ✔ 源字符串。
lookups dynamic ✔ 包含查找字符串的数组。 将忽略非字符串的数组元素。
rewrites dynamic ✔ 包含重写的数组。 将忽略非字符串的数组元素（不进行替换）。

返回

在使用 rewrites 计算结果替换 lookups 的所有匹配项后返回 text。 匹配项不会重叠。

示例

简单替换

运行查询

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
        )
消息 业务成效
A magic trick can turn a cat into a dog A magic trick can turn a dog into a pigeon

替换为空字符串

替换为空字符串会删除匹配的字符串。

运行查询

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
        )
消息 业务成效
A magic trick can turn a cat into a dog A magic trick can disappear a cat

替换顺序

匹配元素的顺序非常重要：以先找到的匹配项优先。 请注意 Outcome1 和 Outcome2 之间的差别：This 与 Thwas。

运行查询

 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
        )
消息 Outcome1 Outcome2
This is an example of using replace_strings() This was an example of using replace_strings() Thwas was an example of using 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
        )
消息 业务成效
This is an example of using replace_strings() This was an example of using replace_strings()

相关内容