replace_strings()

Vervangt alle overeenkomende tekenreeksen door opgegeven tekenreeksen.

Zie replace_string() als u een afzonderlijke tekenreeks wilt vervangen.

Syntax

replace_strings(Tekst,Lookups,Herschrijft)

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
Tekst	string	✔️	De brontekenreeks.
Lookups	dynamic	✔️	De matrix die opzoekreeksen bevat. Matrixelement dat geen tekenreeks is, wordt genegeerd.
Herschrijft	dynamic	✔️	De matrix die herschrijfingen bevat. Matrixelement dat geen tekenreeks is, wordt genegeerd (geen vervanging gemaakt).

Retouren

Retourneert tekst nadat alle overeenkomsten van zoekacties zijn vervangen door evaluaties van herschrijfacties. Overeenkomsten overlappen elkaar niet.

Voorbeelden

Eenvoudige vervanging

De query uitvoeren

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
        )

Bericht	Resultaat
Een magische truc kan van een kat een hond maken	Een magische truc kan van een hond een duif maken

Vervangen door een lege tekenreeks

Als u vervangt door een lege tekenreeks, wordt de overeenkomende tekenreeks verwijderd.

De query uitvoeren

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
        )

Bericht	Resultaat
Een magische truc kan van een kat een hond maken	Een magische truc kan een kat verdwijnen

Vervangende bestelling

De volgorde van de match-elementen is van belang: de eerdere overeenkomst heeft de prioriteit. Let op het verschil tussen Outcome1 en Outcome2: This vs Thwas.

De query uitvoeren

 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
        )

Bericht	Resultaat1	Resultaat2
Dit is een voorbeeld van het gebruik van replace_strings()	Dit was een voorbeeld van het gebruik van replace_strings()	Thwas was een voorbeeld van het gebruik van replace_strings()

Niet-tekenreeksvervanging

Vervangen van elementen die geen tekenreeksen zijn, worden niet vervangen en de oorspronkelijke tekenreeks blijft behouden. De overeenkomst wordt nog steeds als geldig beschouwd en andere mogelijke vervangingen worden niet uitgevoerd op de overeenkomende tekenreeks. In het volgende voorbeeld wordt 'Dit' niet vervangen door de numerieke 12345, en blijft het in de uitvoer, niet beïnvloed door mogelijke overeenkomst met 'is'.

De query uitvoeren

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

Bericht	Resultaat
Dit is een voorbeeld van het gebruik van replace_strings()	Dit was een voorbeeld van het gebruik van replace_strings()

Gerelateerde inhoud

• Zie replace_string() voor een vervanging van één tekenreeks.
• Zie replace_regex() voor een vervanging op basis van een reguliere expressie.
• Zie translate() voor het vervangen van een reeks tekens.