Conteúdo
Índice 🔎︎

# REGEX

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

Esta função está disponível desde o LibreOffice 6.2

### 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";"[:dígito:]";"Z") devolve "Z23456ABCDEF", onde a primeira ocorrência de um dígito é substituída por "Z".

=REGEX("123456ABCDEF";"[:dígito:]";"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