replace_strings()

Substitui todas as correspondências de cadeias de caracteres por cadeias de caracteres especificadas.

Para substituir uma cadeia de caracteres individual, consulte replace_string().

Sintaxe

replace_strings(regravações de, pesquisas de texto, )

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Digitar	Obrigatória	Descrição
text	string	✔️	A cadeia de caracteres de origem.
Pesquisas	dynamic	✔️	A matriz que inclui cadeias de caracteres de pesquisa. O elemento de matriz que não é uma cadeia de caracteres é ignorado.
Regrava	dynamic	✔️	A matriz que inclui regravações. O elemento de matriz que não é uma cadeia de caracteres é ignorado (nenhuma substituição feita).

Devoluções

Retorna texto após substituir todas as correspondências de pesquisas por avaliações de regravações. Correspondências não se sobrepõem.

Exemplos

Substituição simples

Executar a consulta

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
        )

Mensagem	Resultado
Um truque de mágica pode transformar um gato em um cão	Um truque de mágica pode transformar um cão em um pombo

Substituição por uma cadeia de caracteres vazia

A substituição por uma cadeia de caracteres vazia remove a cadeia de caracteres correspondente.

Executar a consulta

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
        )

Mensagem	Resultado
Um truque de mágica pode transformar um gato em um cão	Um truque de mágica pode desaparecer um gato

Ordem de substituição

A ordem dos elementos da partida importa: a partida anterior tem precedência. Observe a diferença entre Desfecho1 e Desfecho2: This vs Thwas.

Executar a consulta

 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
        )

Mensagem	Desfecho1	Desfecho2
Este é um exemplo de uso do replace_strings()	Este foi um exemplo de uso de replace_strings()	Thwas foi um exemplo de uso de replace_strings()

Substituição sem cadeia de caracteres

Substitua elementos que não são cadeias de caracteres não são substituídos e a cadeia de caracteres original é mantida. A correspondência ainda é considerada válida, e outras possíveis substituições não são executadas na cadeia de caracteres correspondente. No exemplo a seguir, 'This' não é substituído pelo numérico 12345e permanece na saída sem ser afetado pela possível correspondência com 'is'.

Executar a consulta

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

Mensagem	Resultado
Este é um exemplo de uso do replace_strings()	Este foi um exemplo de uso de replace_strings()

Conteúdo relacionado

• Para uma substituição de uma única cadeia de caracteres, consulte replace_string().
• Para uma substituição baseada em expressão regular, consulte replace_regex().
• Para substituir um conjunto de caracteres, consulte translate().