Partilhar via


replace_string()

Aplica-se a: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

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

Aliases preteridos: replace()

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

Sintaxe

replace_string( texto,pesquisa,reescrever)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação Tipo Necessário Descrição
texto string ✔️ A cadeia de caracteres de origem.
pesquisa 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 de pesquisa por avaliações de reescrever. As 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

Output

Mensagem Resultado
Um truque de magia pode transformar um gato num cão Um truque de magia pode transformar um hamster num cão

Gerar e modificar uma sequência de números

O exemplo a seguir cria uma tabela com coluna x contendo números de um a cinco, incrementados por um. Ele adiciona a coluna str que concatena "Number is" com a representação de cadeia de caracteres dos valores da coluna x usando a função strcat(). Em seguida, adiciona a coluna replaced onde "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')

Output

x STR substituídos
1 O número é 1.000000 Número era 1,000000
2 O número é 2.000000 Número era 2,000000
3 O número é 3.000000 Número era 3.000000
4 O número é 4.000000 Número era 4,000000
5 O número é 5.000000 O número era 5.000000
  • Para substituir várias cadeias de caracteres, consulte replace_strings().
  • Para substituir cadeias de caracteres com base na expressão regular, consulte replace_regex().
  • Para substituir um conjunto de caracteres, consulte translate().