replace_strings()
適用於:✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel
以指定的字串取代所有字串相符專案。
若要取代個別字串,請參閱 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
)
訊息 | 結果 |
---|---|
魔術可以把貓變成狗 | 魔術可以把狗變成鴿子 |
以空字串取代
以空字串取代 會移除相符的字串。
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
)
訊息 | 結果 |
---|---|
魔術可以把貓變成狗 | 魔術可以消失貓 |
更換訂單
比對元素的順序很重要:先前的相符項目優先。
請注意 Result1 和 Result2 之間的差異: 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
)
訊息 | Result1 | Result2 |
---|---|---|
這是使用 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
)
訊息 | 結果 |
---|---|
這是使用 replace_strings() 的範例 | 這是使用 replace_strings() 的範例 |
相關內容
- 如需取代單一字串,請參閱 replace_string()。
- 如需以正則表示式為基礎的取代,請參閱 replace_regex()。
- 如需取代一組字元,請參閱 translate()。