KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

len: elementen tellen, geen geheugen meten

len retourneert het aantal elementen van een object dat lengte ondersteunt. Bij tekenreeksen telt het Unicode-codepunten, geen bytes of noodzakelijkerwijs zichtbare tekens.

Versie: Python 3.14

Syntax

len(object, /)

Voor een lijst is len([4, 8]) gelijk aan 2. Een dictionary telt sleutels, niet sleutels en waarden samen; opnieuw aan dezelfde sleutel toekennen voegt geen element toe. Een lege container heeft lengte 0. Het resultaat is een niet-negatief geheel getal.

De lengte van een tekenreeks is niet de grootte van de gecodeerde gegevens. Een letter met een afzonderlijk combinatieteken kan eruitzien als één teken terwijl hij twee codepunten bevat. Het voorbeeld vergelijkt zo’n tekenreeks met de UTF-8-weergave. Door gebruikers waargenomen tekens tellen vereist grafeemsegmentatie, niet alleen len.

Niet ieder object heeft een lengte: len(3) en de lengte van een gewone generator veroorzaken TypeError. Een generator omzetten in een lijst verbruikt hem en kan veel geheugen vragen. Heb je alleen een aantal nodig, tel dan tijdens het doorlopen; ook daarbij verbruik je de iterator.

Een eigen klasse kan haar lengte via __len__ bepalen. Ga niet voor iedere klasse uit van constante kosten. In CPython kan een lengte boven sys.maxsize een OverflowError veroorzaken, zelfs wanneer het object een groter bereik voorstelt.

Voorbeelden

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")

Resultaat

2 3
1
TypeError

Bronnen