Função de ER TRANSLATE

A função TRANSLATE devolve um valor Cadeia que contém o resultado da substituição de carateres do texto especificado em carateres de outro conjunto de carateres fornecidos.

Sintaxe

TRANSLATE (text , pattern, replacement)

Argumentos

text: Cadeia

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

pattern: Cadeia

O texto que tem de ser substituído.

replacement: Cadeia

O texto a utilizar como substituição.

Valores de retorno

Cadeia

O valor de texto resultante.

Notas de utilização

A função TRANSLATE substitui um caráter de cada vez. A função substitui o primeiro caráter do argumento text pelo primeiro caráter do argumento pattern e, em seguida, o segundo caráter e segue o mesmo fluxo até terminar. Quando um caráter dos argumentos text e pattern corresponde, é substituído por um caráter do argumento replacement que está localizado na mesma posição que o caráter do argumento pattern. Se um caráter for apresentado várias vezes no argumento pattern, o mapeamento do argumento replacement que corresponde à primeira ocorrência deste caráter é utilizado.

Exemplo 1

TRANSLATE ("abcdef", "cd", "GH") substitui o caráter "c" do texto "abcdef" especificado pelo caráter "G" do texto replacement devido ao seguinte:

• O caráter "c" é apresentado no texto pattern na primeira posição.
• A primeira posição do texto replacement contém o caráter "G".

Exemplo 2

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

Exemplo 3

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

Recursos adicionais

Funções de texto