Jaka jest różnica między iterable a iterator?

Question

Accepted Answer

**Iterable** to wszystko, co możesz przeiterować (lista, string, dict); **iterator** to obiekt, który faktycznie wykonuje iterację, produkując wartości jeden po jednym i śledząc swoją pozycję. Ta distinkcja wyjaśnia, jak działają pętle `for` w Python.

## Dlaczego to ważne

```text
Iterable → has __iter__()  → returns an iterator
Iterator → has __next__()  → returns the next value (and __iter__ returning itself)
```

## Jak naprawdę działa pętla for

```python
# this for loop...
for x in [1, 2, 3]:
    print(x)

# ...is roughly equivalent to:
it = iter([1, 2, 3])    # __iter__ → get an iterator from the iterable
while True:
    try:
        x = next(it)     # __next__ → get the next value
        print(x)
    except StopIteration: # raised when exhausted → loop ends
        break
```

Pętla `for` wywołuje `iter()` aby uzyskać iterator, a następnie wielokrotnie wywołuje `next()` aż do sygnału `StopIteration` oznaczającego koniec. To właśnie ten protokół umożliwia iterowanie po dowolnym iterable.

## Iterable vs iterator w praktyce

```python
nums = [1, 2, 3]        # an ITERABLE (a list)
it = iter(nums)         # an ITERATOR over it

next(it)   # 1
next(it)   # 2
next(it)   # 3
next(it)   # StopIteration

# the list is REUSABLE (get a fresh iterator each loop);
# an iterator is CONSUMED ONCE — exhausted after one pass
list(it)   # [] — already used up
```

Kluczowa różnica: iterable (lista) może być przeiterowany wiele razy (każda `for` otrzymuje świeży iterator); iterator jest **jednorazowy** — po wyczerpaniu jest pusty.

## Budowanie niestandardowego iterator

```python
class Countdown:
    def __init__(self, start): self.n = start
    def __iter__(self): return self          # the iterable returns itself as iterator
    def __next__(self):
        if self.n <= 0:
            raise StopIteration               # signal the end
        self.n -= 1
        return self.n + 1

for x in Countdown(3):   # 3, 2, 1
    print(x)
```

## Generatory są iteratorami

```python
def gen(): yield 1; yield 2     # a generator function returns an iterator automatically
```

Generatory to łatwy sposób na tworzenie iteratorów — `yield` obsługuje dla Ciebie mechanizm `__next__`/`StopIteration`.

## Dlaczego to ważne

Distynkcja iterable/iterator wyjaśnia **jak działają pętle `for`** w Python i jak iteracja jest ujednolicona we wszystkich kolekcjach (listy, dicts, pliki, generatory) poprzez protokół iterator.

Zrozumienie tego wyjaśnia rzeczywiste zachowania — dlaczego iterator może być konsumowany tylko raz (powszechny błąd: przeiterowanie generatora/zip dwukrotnie nic nie daje za drugim razem), dlaczego generatory są iteratorami i jak tworzyć własne obiekty iterable.

Ten protokół jest fundamentem eleganckog, spójnego modelu iteracji Python i jest niezbędny do pracy z generatorami, leniwą oceną i niestandardowymi klasami iterable.