Compartilhar via


Função de ER REPLACE

A função REPLACE retorna a cadeia de caracteres de texto especificada como um valor de Cadeia de caracteres após toda ou parte dela ser substituída por outra cadeia de caracteres.

Sintaxe

REPLACE (text, pattern, replacement, regular expression flag)

Argumentos

text: Cadeia de caracteres

O caminho válido de uma fonte de dados do tipo Cadeia de caracteres.

pattern: Cadeia de caracteres

Se o argumento regular expression flag for FALSE, este argumento conterá o texto que deve ser substituído.

Se o argumento regular expression flag for TRUE, este argumento conterá uma expressão regular que define um padrão de pesquisa e o texto substituto.

replacement: Cadeia de caracteres

Se o argumento regular expression flag for FALSE, este argumento conterá o texto a ser usado como substituto.

Se o argumento regular expression flag for TRUE, este argumento não será usado.

regular expression flag: Booliano

Um valor Booliano que indica se uma expressão regular é usada para fazer a substituição.

Valores de retorno

Sequência de caracteres

O valor de texto resultante.

Notas de uso

Se o argumento regular expression flag for TRUE, esta função retornará a cadeia de caracteres especificada depois de ter sido alterada, aplicando a expressão regular especificada pelo argumento pattern. A expressão regular é usada para encontrar os caracteres que devem ser substituídos.

Se o argumento regular expression flag for FALSE, essa função retorna a cadeia de caracteres especificada após o conjunto de caracteres que foram definidos no argumento pattern foram substituídos pelos caracteres do argumento replacement.

Exemplo 1

REPLACE ("+1 923 456 4971", "[^0-9]", "", true) aplica uma expressão regular que remove todos os símbolos não numéricos e retorna "19234564971".

Exemplo 2

REPLACE ("abcdef", "cd", "GH", false) substitui o padrão "cd" pela cadeia de caracteres "GH" e retorna "abGHef".

Recursos adicionais

Funções de texto