Função REGEX

Módulo
Conteúdo
Índice 🔎︎

# REGEX

Procura e extrai ou, opcionalmente, substitui texto usando de expressões regulares.

### Sintaxe

REGEX( texto ; expressão [ ; [substituição ] [ ; sinais|ocorrência ] ] )

texto: um texto ou referência a uma célula na qual a expressão regular deve ser aplicada.

Expressão: um texto representando a expressão regular, mediante a sintaxe de expressões regulares ICU. Caso não exista ocorrência e substituição não for indicado, a função devolve #N/D.

Substituição: opcional. O texto de substituição e referências para capturar grupos. Se não houver correspondência, é devolvido Texto sem modificações.

Opções: Opcional. "g" substitui todas as correspondências de Expressão no Texto, sem extração. Se não houver correspondência, o Texto é devolvido sem modificações.

Ocorrência: Opcional. Um número para indicar que ocorrência de Expressão em Texto deve ser extraído ou substituído. Se não houver ocorrência e Substituição não existir, devolve #N/DISP. Se não houver ocorrência e houver Substituição, devolve Texto sem modificações. Se a Ocorrência é zero, devolve Texto sem modificações.

### Exemplos

=REGEX("123456ABCDEF";"[:digit:]";"Z") devolve "Z23456ABCDEF", onde a primeira ocorrência de um dígito é substituída por "Z".

=REGEX("123456ABCDEF";"[:digit:]";"Z";"g") devolve "ZZZZZZABCDEF", onde todos os dígitos são substituídos por "Z".

=REGEX("123456ABCDEF";"[126]";"";"g") devolve "345ABCDEF", onde todas as ocorrências de "1", "2" ou "6" são substituídas pelo texto vazio, por consequência, excluídos.

=REGEX("axbxcxd";".x";;2) devolve "bx", a segunda ocorrência de ".x".

=REGEX("axbxcxd";"(.)x";"$1y";2) devolve "axbycxd", a segunda ocorrência de "(.)x" (i.e. "bx") substituída pelo grupo de captura de um caractere (i.e. "b") seguido por "y".

Tópicos relacionados

Lista de expressões regulares

Expressões regulares de ICU (em inglês).