Compartilhar via


replace_string()

Aplica-se a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

Substitui todas as correspondências de cadeia de caracteres por uma cadeia de caracteres especificada.

Apelidos obsoletos: replace()

Para substituir várias cadeias de caracteres, consulte replace_strings().

Sintaxe

replace_string( , , )

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
text string ✔️ A cadeia de caracteres de origem.
lookup string ✔️ A cadeia de caracteres a ser substituída.
reescrever string ✔️ A Cadeia de caracteres de substituição.

Devoluções

Retorna o texto depois de substituir todas as correspondências de pesquisa por avaliações de reescrita. Correspondências não se sobrepõem.

Exemplos

Substituir palavras em uma cadeia de caracteres

O exemplo a seguir usa replace_string() para substituir a palavra "gato" pela palavra "hamster" na cadeia de caracteres Message.

print Message="A magic trick can turn a cat into a dog"
| extend Outcome = replace_string(
        Message, "cat", "hamster")  // Lookup strings

Saída

Mensagem Resultado
Um truque de mágica pode transformar um gato em um cachorro Um truque de mágica pode transformar um hamster em um cachorro.

Gerar e modificar uma sequência de números

O exemplo a seguir cria uma tabela com x de coluna contendo números de um a cinco, incrementados por um. Ele adiciona a coluna str que concatena "Número é" com a representação de cadeia de caracteres dos valores da coluna x usando a função strcat(). Em seguida, ele adiciona a coluna replaced em que "was" substitui a palavra "is" nas cadeias de caracteres da coluna str.

range x from 1 to 5 step 1
| extend str=strcat('Number is ', tostring(x))
| extend replaced=replace_string(str, 'is', 'was')

Saída

x str replaced
1 O número é 1,000000 O número era 1,000000
2 O número é 2,000000 O número era 2,000000
3 O número é 3,000000 O número era 3,000000
4 O número é 4,000000 O número era 4,000000
5 O número é 5,000000 O número era 5.000000