Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

len: quantidade de elementos, não memória ocupada

len devolve o número de elementos de um objeto que suporta comprimento. Nas cadeias de caracteres conta pontos de código Unicode, não bytes nem necessariamente os caracteres que uma pessoa vê.

Versão: Python 3.14

Sintaxe

len(object, /)

Para uma lista, len([4, 8]) vale 2. Num dicionário contam-se as chaves, não as chaves e os valores em conjunto; atribuir novamente a mesma chave não acrescenta um elemento. Um contentor vazio tem comprimento 0. O resultado é um inteiro não negativo.

O comprimento de uma cadeia não é o tamanho dos dados codificados. Uma letra seguida de uma marca combinatória pode parecer um só carácter embora contenha dois pontos de código. O exemplo compara essa cadeia com a sua representação UTF-8. Contar caracteres percebidos pelo utilizador exige segmentação de grafemas, não apenas len.

Nem todos os objetos têm comprimento: len(3) e o comprimento de um gerador normal provocam TypeError. Converter um gerador numa lista consome-o e pode exigir muita memória. Se precisas apenas de uma contagem, conta durante a iteração, lembrando que também consomes o iterador.

Uma classe própria pode definir o comprimento através de __len__. Não assumas um custo constante para todas as classes. Em CPython, um comprimento superior a sys.maxsize pode provocar OverflowError, mesmo que o objeto represente um intervalo maior.

Exemplos

text = "e\u0301"
print(len(text), len(text.encode("utf-8")))
print(len({"a": 1, "a": 2}))
values = (number for number in range(3))
try:
    print(len(values))
except TypeError:
    print("TypeError")

Resultado

2 3
1
TypeError

Fontes