Partager via


replace_strings()

S’applique à : ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Remplace toutes les correspondances de chaînes par des chaînes spécifiées.

Pour remplacer une chaîne individuelle, consultez replace_string().

Syntaxe

replace_strings(réécriture des, recherches de texte, )

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
texte string ✔️ Chaîne source.
Recherches dynamic ✔️ Tableau qui inclut des chaînes de recherche. L’élément array qui n’est pas une chaîne n’est pas ignoré.
Réécrit dynamic ✔️ Tableau qui inclut des réécritures. L’élément array qui n’est pas une chaîne n’est pas ignoré (aucun remplacement n’a été effectué).

Retours

Retourne du texte après avoir remplacé toutes les correspondances de recherches par des évaluations de réécritures. Les correspondances ne se chevauchent pas.

Exemples

Remplacement simple

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 Résultat
Un tour magique peut transformer un chat en chien Un tour magique peut transformer un chien en pigeon

Remplacement par une chaîne vide

Le remplacement par une chaîne vide supprime la chaîne correspondante.

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 Résultat
Un tour magique peut transformer un chat en chien Un tour magique peut disparaître un chat

Ordre de remplacement

L’ordre des éléments de correspondance est important : la correspondance précédente est prioritaire. Notez la différence entre le résultat1 et le résultat2 : This vs 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
        )
Message Résultat1 Résultat2
Il s’agit d’un exemple d’utilisation de replace_strings() Il s’agissait d’un exemple d’utilisation de replace_strings() Thwas était un exemple d’utilisation de replace_strings()

Remplacement non chaîne

Les éléments de remplacement qui ne sont pas des chaînes ne sont pas remplacés et la chaîne d’origine est conservée. La correspondance est toujours considérée comme valide et d’autres remplacements possibles ne sont pas effectués sur la chaîne correspondante. Dans l’exemple suivant, « This » n’est pas remplacé par le nombre 12345, et il reste dans la sortie non affectée par la correspondance possible avec « 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 Résultat
Il s’agit d’un exemple d’utilisation de replace_strings() Il s’agissait d’un exemple d’utilisation de replace_strings()
  • Pour remplacer une seule chaîne, consultez replace_string().
  • Pour un remplacement basé sur l’expression régulière, consultez replace_regex().
  • Pour remplacer un ensemble de caractères, consultez translate().