Partilhar via


Função de ER REPLACE

A função REPLACE devolve a cadeia de texto especificada como um valor Cadeia depois de ter sido integral ou parcialmente substituída por outra cadeia.

Sintaxe

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

Argumentos

text: Cadeia

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

pattern: Cadeia

Se o argumento regular expression flag for FALSO, este argumento contém o texto que tem de ser substituído.

Se o argumento regular expression flag for VERDADEIRO, este argumento contém uma expressão regular que define tanto um padrão de pesquisa como o texto de substituição.

replacement: Cadeia

Se o argumento regular expression flag for FALSO, este argumento contém o texto a utilizar como substituição.

Se o argumento regular expression flag for VERDADEIRO, este argumento não é utilizado.

regular expression flag: Booleano

Um valor Booleano que indica se uma expressão regular é utilizada para efetuar a substituição.

Valores de retorno

Cadeia

O valor de texto resultante.

Notas de utilização

Se o argumento regular expression flag for VERDADEIRO, esta função devolve a cadeia especificada depois de ter sido alterada aplicando a expressão regular especificada pelo argumento pattern. A expressão regular é utilizada para localizar os carateres que têm de ser substituídos.

Se o argumento regular expression flag for FALSO, esta função devolve a cadeia especificada depois de o conjunto de carateres definidos no argumento pattern ter sido substituído por carateres 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 devolve "19234564971".

Exemplo 2

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

Recursos adicionais

Funções de texto