As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Função ENCODE
<a name="ENCODE"></a>

A função ENCODE é usada para converter uma string em sua representação binária usando uma codificação de caracteres especificada.

Essa função é útil quando você precisa trabalhar com dados binários ou quando precisa converter entre diferentes codificações de caracteres. Por exemplo, você pode usar a função ENCODE ao armazenar dados em um banco de dados que requer armazenamento binário ou quando precisar transferir dados entre sistemas que usam codificações de caracteres diferentes.

## Sintaxe
<a name="ENCODE-syntax"></a>

```
encode(str, charset)
```

## Argumentos
<a name="ENCODE-arguments"></a>

 *str*   
Uma expressão STRING a ser codificada.

 *conjunto de caracteres*   
Uma expressão STRING especificando a codificação.  
Codificações de conjuntos de caracteres compatíveis (sem distinção entre maiúsculas e minúsculas):`'US-ASCII'`,,`'ISO-8859-1'`,`'UTF-8'`, e. `'UTF-16BE'` `'UTF-16LE'` `'UTF-16'`

## Tipo de retorno
<a name="ENCODE-return-type"></a>

A função ENCODE retorna um BINÁRIO.

## Exemplo
<a name="ENCODE-example"></a>

O exemplo a seguir converte `'abc'` a string em sua representação binária usando a `'utf-8'` codificação, o que, nesse caso, resulta no retorno da string original. Isso ocorre porque a `'utf-8'` codificação é uma codificação de caracteres de largura variável que pode representar todo o conjunto de caracteres ASCII (que inclui as letras `'a'``'b'`, e`'c'`) usando um único byte por caractere. Portanto, a representação binária do `'abc'` uso `'utf-8'` é a mesma da string original.

```
SELECT encode('abc', 'utf-8');
 abc
```