# CHAR

> Função CHAR no StackQL: os caracteres de um ou mais códigos de caractere, para inserir quebras de linha, aspas, tabulações e outros caracteres de controle em strings.

Source: https://stackql.io/pt-br/language-spec/functions/string/char

A função `CHAR()` retorna o caractere correspondente ao código ASCII especificado.

Veja também:  
[[`SELECT`]](/language-spec/select)

* * *

:::note
Ao usar o StackQL com um backend PostgreSQL, a função equivalente é `CHR()`.
:::

## Sintaxe

```sql
SELECT CHAR(ascii_code) FROM <multipartIdentifier>;
```

> A função `CHAR()` retorna o caractere associado ao código ASCII fornecido.

## Argumentos

**_ascii_code_**  
Um inteiro que representa o código ASCII do caractere desejado.

## Valor(es) retornado(s)

Retorna uma string de um único caractere correspondente ao código ASCII especificado.

* * *

## Códigos ASCII comuns

| Caractere     | Descrição             | Código ASCII | Exemplo de uso                  |
|---------------|-----------------------|--------------|---------------------------------|
| `\n`          | Nova linha            | 10           | `CHAR(10)`                      |
| `'`           | Aspas simples         | 39           | `CHAR(39)`                      |
| `"`           | Aspas duplas          | 34           | `CHAR(34)`                      |
| (espaço)      | Espaço                | 32           | `CHAR(32)`                      |
| `:`           | Dois-pontos           | 58           | `CHAR(58)`                      |
| `;`           | Ponto e vírgula       | 59           | `CHAR(59)`                      |
| `\t`          | Tabulação horizontal  | 9            | `CHAR(9)`                       |
| `\r`          | Retorno de carro      | 13           | `CHAR(13)`                      |
| `\b`          | Retrocesso            | 8            | `CHAR(8)`                       |
| `\f`          | Avanço de página      | 12           | `CHAR(12)`                      |

* * *

## Exemplos

### Concatenar strings com caracteres especiais

Para concatenar strings com um caractere de nova linha entre elas:

```sql
SELECT 
'/* ' || displayName || ' */' || CHAR(10) || 'DELETE FROM databricks_account.iam.account_users WHERE account_id = ' || CHAR(39) || account_id || CHAR(39) || ' AND id = ' || CHAR(39) || id || CHAR(39)
FROM
databricks_account.iam.account_users
where account_id = 'abcd1234-1234-5678-90ab-abcdef123456'
AND active = false;
```

**Resultado** (para um usuário com o nome de exibição `Jane Doe` e o ID `1234567890123456`):

```
/* Jane Doe */
DELETE FROM databricks_account.iam.account_users WHERE account_id = 'abcd1234-1234-5678-90ab-abcdef123456' AND id = '1234567890123456'
```

* * *
