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 CHAR\$1LENGTH no Amazon QLDB
<a name="ql-functions.char_length"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `CHAR_LENGTH` para retornar o número de caracteres na string especificada, em que o *caractere* é definido como um único ponto de código Unicode.

## Sintaxe
<a name="ql-functions.char_length.syntax"></a>

```
CHAR_LENGTH ( string )
```

`CHAR_LENGTH` é sinônimo de [Função CHARACTER\$1LENGTH no Amazon QLDB](ql-functions.character_length.md).

## Argumentos
<a name="ql-functions.char_length.arguments"></a>

*string*  
O nome do campo ou a expressão do tipo de dados `string` que a função avalia.

## Tipo de retorno
<a name="ql-functions.char_length.return-type"></a>

`int`

## Exemplos
<a name="ql-functions.char_length.examples"></a>

```
SELECT CHAR_LENGTH('') FROM << 0 >>        -- 0
SELECT CHAR_LENGTH('abcdefg') FROM << 0 >> -- 7
SELECT CHAR_LENGTH('eࠫ') FROM << 0 >>      -- 2 (because 'eࠫ' is two code points: the letter 'e' and combining character U+032B)
```

## Funções relacionadas
<a name="ql-functions.char_length.related"></a>
+ [LOWER](ql-functions.lower.md)
+ [SUBSTRING](ql-functions.substring.md)
+ [TRIM](ql-functions.trim.md)
+ [UPPER](ql-functions.upper.md)