# TRANSLATE

Traduz o valor fornecido usando um determinado dicionário.

## Sintaxe

```
TRANSLATE(dictionary, keepValuesWithoutTranslation, emptyAsNull, input)
```

## Argumentos

| Nome | Tipo | Descrição | Valor padrão |
| --- | --- | --- | --- |
| dictionary | caractere |  |  |
| keepValuesWithoutTranslation | valor booleano | Se deve manter valores que não estão mapeados para um valor no recurso |  |
| emptyAsNull | valor booleano | Se definido, valores vazios serão tratados como nulos |  |
| input | string/numeric |  |  |

## Retorna

Retorna um valor `string`.

***

## Exemplos

| dictionary | keepValuesWithoutTranslation | emptyAsNull | input | Saída |
| --- | --- | --- | --- | --- |
| 'a,Antman |  |  |  |  |
| b,Batman |  |  |  |  |
| d,' | false | false | 'a' | `Antman` |
| 'a,Antman |  |  |  |  |
| b,Batman |  |  |  |  |
| d,' | false | false | 'b' | `Batman` |
| 'a,Antman |  |  |  |  |
| b,Batman |  |  |  |  |
| d,' | false | false | 'c' | nulo |
| 'a,Antman |  |  |  |  |
| b,Batman |  |  |  |  |
| d,' | true | false | 'c' | `c` |
| 'a,Antman |  |  |  |  |
| b,Batman |  |  |  |  |
| d,' | true | true | 'd' | nulo |
| 'a,Antman |  |  |  |  |
| b,Batman |  |  |  |  |
| d,' | true | false | 'd' | `` |
| '1234.0,good' | false | false | 1234 | `good` |
| '1234.0,good' | false | false | 1234 | `good` |
| '0.0,good' | false | false | 0 | `good` |
| '-0.0,good' | false | false | 0 | `good` |
| '-0.0,good' | false | false | 0 | `good` |
| '1.23456e17,good' | false | false | 123456000000000000 | `good` |
| '6.000000000000001,good' | false | false | 6 | nulo |