A função REGEXREPLACE permite substituir o texto de uma cadeia de caracteres por outra cadeia de caracteres, com base em uma expressão regular fornecida ("regex").
Sintaxe
A função REGEXREPLACE substitui cadeias de caracteres dentro do texto fornecido que correspondem ao padrão com substituição.
A sintaxe da função REGEXEXTRACT é:
REGEXREPLACE(texto, padrão, substituição, [ocorrência], [case_sensitivity])
| Argumento | Descrição |
|---|---|
|
texto (obrigatório) |
O texto ou a referência a uma célula que contém o texto onde você deseja substituir as cadeias de caracteres. |
|
padrão (obrigatório) |
A expressão regular ("regex") que descreve o padrão de texto que você deseja substituir. |
|
de substituição (obrigatório) |
O texto que você deseja substituir instâncias de padrão. |
| Ocorrência | Especifica qual instância do padrão você deseja substituir. Por padrão, a ocorrência é 0, que substitui todas as instâncias. Um número negativo substitui essa instância, pesquisando a partir do final. |
| case_sensitivity | Determina se a correspondência diferencia maiúsculas de minúsculas. Por padrão, a correspondência diferencia maiúsculas de minúsculas. Insira uma das seguintes opções: 0: Diferenciar maiúsculas de minúsculas 1: Não diferenciar maiúsculas de minúsculas |
Observação
Ao escrever padrões regex, podem ser usados símbolos chamados 'tokens' que correspondem a uma variedade de caracteres. Estes são alguns tokens simples para referência:
- "[0-9]": qualquer dígito numérico
- "[a-z]": um caractere no intervalo de A a Z
- ".": qualquer caractere
- "a": o caractere "a"
- "a*": zero ou mais "a"
- "a+": um ou mais "a"
- Todas as expressões regulares para esta função, bem como REGEXTEST e REGEXEXTRACT , usam o 'sabor' PCRE2 de regex.
- REGEXEXTRACT sempre retorna valores de texto. Você pode converter esses resultados novamente em um número com a função VALOR.
Exemplos
Copie os dados de exemplo e cole-os na célula A1 de uma nova planilha do Excel. Se precisar, você poderá ajustar as larguras das colunas para ver todos os dados.
Exemplo 1
Use REGEXREPLACE para anonimizar números de telefone substituindo seus primeiros 3 dígitos por ***, usando padrão
"[0-9]+-"
| Dados |
|---|
| Sônia Rees (378) 555-4195 Anjo Brown(878) 555-8622 Blake Martin (437) 555-8987 William Kirby (619) 555-4212 Avery Smith (579) 555-5658 Parker Jones(346) 555-0925 Liam Pequeno(405) 555-0887 Hollie Rees (666) 555-1872 |
| Fórmulas |
| =REGEXREPLACE(A2,"[0-9]+-","***-") |
A ilustração a seguir mostra o resultado. Você precisará quebrar o texto na célula A4 para mostrar as quebras de linha no resultado.
![Usando REGEXREPLACE para substituir os três primeiros dígitos de cada número de telefone em texto misto por *, usando o padrão [0-9]+-](../media/regexreplace-example-1.png)
Exemplo 2
Use REGEXREPLACE com a captura de grupos para separar e reordenar o nome e o sobrenome, usando pattern: "([A-Z][a-z]+)([A-Z][a-z]+)"; e substituição: "$ 2, $ 1".
Observação: Os grupos de captura são definidos no padrão com parênteses "()" e podem ser referenciados em substituição como "$n". Neste exemplo, $1 e $2 fazem referência ao primeiro e ao segundo grupos de captura, respectivamente.
| Dados |
|---|
| SoniaBrown |
| Fórmulas |
| =REGEXREPLACE(A2,"([A-Z][a-z]+)([A-Z][a-z]+)","$2, $1") |
A ilustração a seguir mostra os resultados.
![Use REGEXREPLACE com a captura de grupos para separar e reordenar nome e sobrenome, usando padrão: ([A-Z][a-z]+)([A-Z][a-z]+) e substituição: US$ 2, US$ 1](../media/regexreplace-example-2.png)