Ir para conteúdo principal Pular para conteúdo complementar

ReplaceRegEx – função de script e gráfico

ReplaceRegEx() retorna uma string após substituir uma ou mais correspondências entre uma string de entrada e um padrão de expressão regular especificado. O texto que substitui o texto correspondente é especificado no argumento to_str. A função funciona da esquerda para a direita, mas, se você especificar um valor occurrence negativo, as funções serão lidas da direita para a esquerda.

Essa função executa operações regex que diferenciam maiúsculas de minúsculas. Como alternativa, você pode usar a variante ReplaceRegExI() para realizar operações de regex sem distinção entre maiúsculas e minúsculas.

Sintaxe:  

ReplaceRegEx (text, regex, to_str [, occurrence])

Tipo de dados de retorno: caractere

Argumentos
Argumento Descrição
text O texto da string de entrada que você deseja substituir, total ou parcialmente, pelo novo texto de to_str.
regex A expressão regular que define quando substituir o texto. As correspondências entre esse argumento e o argumento text são substituídas.
to_str O novo texto que você deseja usar para substituir o conteúdo existente em text.
occurrence

O número da correspondência (entre o texto de entrada e a expressão regular) a ser substituída pelo novo texto.

Este é um argumento opcional. O padrão é 0 se for omitido. Quando um valor de 0 é usado, ou se o argumento for omitido, todas as correspondências entre text e regex são substituídas por to_str.

Você pode especificar um valor negativo para occurrence se quiser identificar correspondências da direita para a esquerda.

Exemplos de funções
Exemplo Resultado
ReplaceRegEx('abc123','[0-9]','x') Retorna abcxxx. Nesse exemplo, todo o texto da string de entrada que corresponde ao padrão regex é substituído pelo novo texto.
ReplaceRegEx('abc123','[0-9]','x',1) Retorna abcx23. Somente a primeira ocorrência de uma correspondência entre a string de entrada e o padrão regex é substituída.
ReplaceRegEx('abc123','[0-9]','x',4) Retorna abc123 . Há apenas três correspondências possíveis entre a string de entrada e o padrão regex, portanto, nenhuma modificação é realizada.
ReplaceRegEx('ABC123','[a-c]','5') Retorna ABC123. Nenhuma modificação é realizada porque o ReplaceRegEx() diferencia maiúsculas de minúsculas e a variante que não diferencia maiúsculas de minúsculas não é usada.
ReplaceRegExI('ABC123','[a-c]','5') Retorna 555123. A variante da função que não diferencia maiúsculas de minúsculas, ReplaceRegExI(), é usada.

Quando usar

Você pode usar o ReplaceRegEx() para modificar texto para atender aos padrões de formatação e conformidade, especialmente quando existem padrões complexos nos dados. Por exemplo, você pode reformatar sequências de números de telefone para que somente valores numéricos sejam incluídos.

Se necessário, você também pode usar esse recurso para mascarar informações confidenciais, como informações de identificação pessoal (PII), para que elas não sejam mostradas aos usuários que analisam seu aplicativo.

Exemplo 1 – script de carregamento para atualizar os endereços de e-mail dos funcionários

Exemplo 2 – script de carregamento para formatar códigos ISBN

Exemplo 3 – expressão de gráfico para atualizar endereços de e-mail secundários

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!