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