Masz listę rekordów i chcesz sprawdzić, ile elementów trafi do kolejnego etapu przetwarzania. Najczęściej wystarczy len(dane), ale wynik zależy od tego, czy obiekt ma określoną długość, a w przypadku tekstu nie zawsze oznacza liczbę widocznych znaków.
W skrócie: len() liczy elementy obiektu, który udostępnia długość
- Składnia: wywołaj
len(obiekt), bez kropki i bez argumentu w nawiasie. - Słownik: wynikiem jest liczba kluczy, a nie suma wszystkich wartości.
- Generator:
len()zwykle zgłosiTypeError, bo generator nie przechowuje gotowego rozmiaru. - Tekst: długość oznacza liczbę punktów kodowych Unicode, nie zawsze liczbę znaków widzianych na ekranie.
- Własna klasa: obsługę długości zapewnia metoda
__len__().
len() zwraca liczbę elementów, nie samą wartość
Gdy potrzebujesz sprawdzić rozmiar listy, tekstu albo słownika, użyj wbudowanej funkcji len(). Uważam, że jej najczytelniejsza forma jest też najprostsza: len(dane), gdzie dane to obiekt, którego długość chcesz poznać.
nazwy = ["Ala", "Olek", "Iga"]
print(len(nazwy)) # 3
tekst = "Python"
print(len(tekst)) # 6
ustawienia = {"motyw": "ciemny", "jezyk": "pl"}
print(len(ustawienia)) # 2
Wynik jest liczbą całkowitą. W przypadku słownika funkcja liczy klucze, więc powyższy przykład zwraca dwa, choć każdemu kluczowi przypisano osobną wartość. Takie zachowanie jest przydatne, gdy liczysz rekordy, ale może zaskoczyć, jeśli myślisz o całej zawartości słownika jako o parach klucz-wartość.
Lista, zbiór i słownik liczą różne rodzaje zawartości
Ta sama funkcja działa na wielu typach, lecz „element” oznacza w nich coś innego. Lista zachowuje powtórzenia, a zbiór przechowuje tylko unikalne wartości, więc identyczne dane mogą dać różne wyniki.
| Obiekt | Co liczy len() |
Przykład |
|---|---|---|
list lub tuple |
Pozycje, także powtórzone | len([4, 4, 9]) daje 3 |
set |
Unikalne elementy | len({4, 4, 9}) daje 2 |
dict |
Klucze | len({"x": 1, "y": 2}) daje 2 |
str |
Punkty kodowe Unicode | len("kot") daje 3 |
bytes |
Bajty | len(b"ABC") daje 3 |
Ten podział pomaga dobrać właściwy obiekt do zadania. Jeśli chcesz policzyć unikalne identyfikatory, najpierw zamień dane na zbiór; jeśli interesuje cię liczba wszystkich wpisów wraz z duplikatami, zostań przy liście.
len() tekstu nie zawsze odpowiada liczbie widocznych znaków
W tekście złożonym z liter łacińskich wynik zwykle zgadza się z intuicją. Schody zaczynają się przy emoji i znakach diakrytycznych, ponieważ Python traktuje str jako sekwencję punktów kodowych Unicode, a nie gotowych symboli wyświetlanych jako jeden glif.
Na przykład len("e\u0301") zwraca 2: zapis zawiera literę „e” oraz osobny znak łączący akcent. Podobnie emoji złożone z kilku punktów kodowych może wyglądać jak jeden symbol, a mimo to mieć długość większą niż jeden. Definicję tekstu jako sekwencji punktów kodowych opisuje dokumentacja typów wbudowanych Pythona.
Jeśli walidujesz limit znaków w polu formularza, najpierw ustal, co oznacza limit w twoim produkcie: bajty, punkty kodowe czy widoczne jednostki tekstu. len() wystarczy do pierwszych dwóch przypadków tylko po odpowiednim dobraniu typu, ale nie rozwiązuje samodzielnie liczenia znaków postrzeganych przez użytkownika.
Generator trzeba policzyć inaczej niż listę
Wyrażenie generatorowe może dostarczać elementy po kolei, ale nie udostępnia gotowej długości. Dlatego len(x for x in range(5)) kończy się błędem TypeError, choć generator można przejść w pętli.
Jeśli dane są małe i możesz je zachować w pamięci, zamień generator na listę, a potem policz elementy:
wyniki = (x * 2 for x in range(5))
elementy = list(wyniki)
print(len(elementy)) # 5
Ta zamiana zużywa generator i zapisuje wyniki w pamięci. Przy dużym pliku lub strumieniu danych lepiej policzyć elementy podczas ich przetwarzania:
liczba = 0
for rekord in generator_rekordow():
liczba += 1
przetworz(rekord)
print(liczba)
Wybór jest prosty: użyj list(), gdy później potrzebujesz wszystkich elementów; zliczaj w pętli, gdy wystarczy liczba i nie chcesz przechowywać całości. Dokumentacja funkcji wbudowanych Pythona opisuje len() jako funkcję dla sekwencji i kolekcji, a nie dowolnego obiektu iterowalnego.
Własna klasa może obsługiwać len() przez __len__()
Jeśli tworzysz klasę reprezentującą kolekcję, możesz zdefiniować jej zachowanie dla len() metodą __len__(). Metoda powinna zwracać nieujemną liczbę całkowitą, zwykle długość wewnętrznej listy lub innego kontenera.
class Rejestr:
def __init__(self):
self.wpisy = []
def dodaj(self, wpis):
self.wpisy.append(wpis)
def __len__(self):
return len(self.wpisy)
rejestr = Rejestr()
rejestr.dodaj("logowanie")
print(len(rejestr)) # 1
Implementacja ma też efekt uboczny, o którym łatwo zapomnieć: gdy klasa nie definiuje własnej metody __bool__(), obiekt z długością zero jest uznawany za fałszywy w warunku if. W praktyce if rejestr: może więc sprawdzać, czy kolekcja jest niepusta, a nie tylko czy obiekt istnieje. Takie powiązanie opisuje model danych Pythona.
W kodzie własnych kolekcji zwykle lepiej zachować standardowe znaczenie tej metody. Jeśli długość oznacza coś innego niż liczbę elementów, prosty warunek może stać się mylący dla kolejnej osoby czytającej kod.
Wybierz funkcję zgodnie z pytaniem, które zadajesz
Łatwo pomylić liczenie z wyszukiwaniem albo obróbką liczby. len() zwraca rozmiar, metoda find() szuka pozycji tekstu, a round() zaokrągla liczbę. Jeśli przechodzisz między językami, podobne rozróżnienie widać przy metodzie find() w JavaScript, która szuka elementu spełniającego warunek zamiast zwracać liczebność kolekcji.
| Sytuacja | Co może być przyczyną lub skutkiem | Co zrobić |
|---|---|---|
len(generator) zgłasza TypeError |
Generator nie udostępnia ustalonej długości | Policz elementy w pętli albo zamień generator na listę, jeśli możesz ją przechować |
len(slownik) daje mniej, niż oczekujesz |
Liczone są klucze, nie osobno klucze i wartości | Sprawdź, czy interesuje cię liczba kluczy, czy liczba elementów w konkretnej wartości |
len(tekst) nie pasuje do liczby symboli na ekranie |
Jeden widoczny symbol może składać się z wielu punktów kodowych | Ustal, czy limit ma dotyczyć bajtów, punktów kodowych czy znaków widocznych |
len(obiekt) zgłasza TypeError dla własnej klasy |
Klasa nie definiuje obsługi długości | Dodaj __len__(), jeśli obiekt rzeczywiście ma sensowną długość |
Przy obliczeniach liczbowych nie zastępuj len() przez zaokrąglanie. Gdy potrzebujesz zaokrąglić wynik, użyj funkcji round w Pythonie; liczba elementów kolekcji pozostaje osobną informacją i nie wymaga zaokrąglenia.
Najpierw ustal, co ma oznaczać „długość”
W codziennym kodzie len(obiekt) jest dobrym wyborem dla list, krotek, słowników, zbiorów i tekstu, o ile wiesz, co dany typ liczy. Przy generatorach i innych strumieniach wybierz jawne zliczanie, a przy tekście przeznaczonym dla użytkownika sprawdź, czy liczba punktów kodowych odpowiada twojemu limitowi.
Najkrótsza zasada brzmi: najpierw określ, co w danym obiekcie jest elementem, dopiero potem wywołaj len(). Dzięki temu wynik nie będzie poprawny składniowo, lecz błędny z punktu widzenia zadania.
