Categories:

String & Binary Functions (General)

# TRANSLATE¶

The TRANSLATE() function replaces characters in a string. Specifically, given a string, a set of characters to replace, and the characters to substitute for the original characters, TRANSLATE() makes the specified substitutions.

## Syntax¶

TRANSLATE( <subject>, <sourceAlphabet>, <targetAlphabet> )


## Arguments¶

subject

A string expression that is translated. If a character in subject is not contained in sourceAlphabet, the character is added to the result without any translation.

sourceAlphabet

A string with all characters that are modified by this function. Each character is either translated to the corresponding character in the targetAlphabet or omitted in the result if the targetAlphabet has no corresponding character (i.e. has fewer characters than the sourceAlphabet).

targetAlphabet

A string with all characters that are used to replace characters from the sourceAlphabet.

## Collation Details¶

Arguments with collation specifications are currently not supported.

## Examples¶

Translate the character ‘ñ’ to ‘n’.

SELECT TRANSLATE('peña','ñ','n');
+---------------------------+
| TRANSLATE('PEÑA','Ñ','N') |
|---------------------------|
| pena                      |
+---------------------------+


Translate ‘X’ to ‘c’, ‘Y’ to ‘e’, ‘Z’ to ‘f’ and remove ‘❄’ characters:

SELECT TRANSLATE('❄a❄bX❄dYZ❄','XYZ❄','cef');
+--------------------------------------+
| TRANSLATE('❄A❄BX❄DYZ❄','XYZ❄','CEF') |
|--------------------------------------|
| abcdef                               |
+--------------------------------------+