Conteúdo
Índice 🔎︎

# EXPREG

Corresponde e extrai ou, opcionalmente, substitui o texto usando expressões regulares.

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

#### Sintaxe

REGEXP( Texto ; Expressão [ ; [ Substituição ] [ ; Opções | Ocorrências] ] )

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 dado, devolve #N/D.

Substituição: opcional. O texto de substituição e referências para grupos de captura. Se não houver correspondência, o Texto é retornado 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 é retornado 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. Senão houver ocorrência e Substituição não existir, retorna #N/DISP. Se não houver ocorrência e houver Substituição, retorna Texto sem modificações. Se Ocorrência é zero, retorna Texto sem modificações.

#### Exemplos

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

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

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

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

=EXPREG("axbxcxd";"(.)x";"$1y";2) retorna "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 ICU