Função de ER TRANSLATE

A função TRANSLATE retorna um valor Cadeia de caracteres que contém o resultado da substituição de caractere do texto especificado em caracteres para outro conjunto fornecido.

Sintaxe

TRANSLATE (text , pattern, replacement)

Argumentos

text: Cadeia de caracteres

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

pattern: Cadeia de caracteres

O texto que deve ser substituído.

replacement: Cadeia de caracteres

O texto a ser usado como substituto.

Valores de retorno

Sequência de caracteres

O valor de texto resultante.

Notas de uso

A função TRANSLATE substitui um caractere por vez. A função substitui o primeiro caractere do argumento text pelo primeiro caractere do argumento pattern e, em seguida, o segundo caractere e segue o mesmo fluxo até concluir. Quando um caractere dos argumentos text e pattern é correspondente, ele é substituído por um caractere do argumento replacement localizado na mesma posição que o caractere do argumento pattern. Se um caractere aparecer várias vezes no argumento pattern, será usado o mapeamento de argumento replacement que corresponde à primeira ocorrência deste caractere.

Exemplo 1

TRANSLATE ("abcdef", "cd", "GH") substitui o caractere "c" do texto “abcdef” especificado com o caractere "G" do texto replacement devido ao seguinte:

• O caractere "c" é apresentado no texto pattern da primeira posição.
• A primeira posição do texto replacement contém o caractere "G".

Exemplo 2

TRANSLATE ("abcdef", "ccd", "GH") retorna "abGdef".

Exemplo 3

TRANSLATE ("abccba", "abc", "123") retorna "123321".

Recursos adicionais

Funções de texto