Função LEN

Retorna o tamanho da string especificada como número de caracteres.

Sintaxe

LEN é um sinônimo de Função LENGTH, Função CHAR_LENGTH, Função CHARACTER_LENGTH e Função TEXTLEN.

LEN(expression)

Argumento

expressão

O parâmetro de entrada é CHAR ou VARCHAR ou um alias de um dos tipos de entrada válidos.

Tipo de retorno

A função LEN retorna um inteiro indicando o número de caracteres em string de entrada.

Se a string de entrada for uma cadeia de caracteres, a função LEN retornará o número real de caracteres em strings multibyte, e não o número de bytes. Por exemplo, uma coluna VARCHAR(12) deve armazenar três caracteres chineses de quatro bytes. A função LEN retornará 3 para esta string.

Observações de uso

Os cálculos de comprimento não contam espaços finais para strings de caracteres de comprimento fixo, mas os contam para strings de comprimento variável.

Exemplo

O exemplo a seguir retorna o número de bytes e o número de caracteres na string français.

select octet_length('français'), 
len('français');

octet_length  | len
--------------+-----
           9  |   8

O seguinte exemplo retorna o número de caracteres nas strings cat sem espaços finais e cat com três espaços finais:

select len('cat'), len('cat   ');
 len | len
-----+-----
   3 |   6

O seguinte exemplo retorna as dez entradas mais longas de VENUENAME na tabela VENUE:

select venuename, len(venuename)
from venue
order by 2 desc, 1
limit 10;

venuename                               | len
----------------------------------------+-----
Saratoga Springs Performing Arts Center |  39
Lincoln Center for the Performing Arts  |  38
Nassau Veterans Memorial Coliseum       |  33
Jacksonville Municipal Stadium          |  30
Rangers BallPark in Arlington           |  29
University of Phoenix Stadium           |  29
Circle in the Square Theatre            |  28
Hubert H. Humphrey Metrodome            |  28
Oriole Park at Camden Yards             |  27
Dick's Sporting Goods Park              |  26