Apakah perbezaan antara iterable dan iterator?

Question

Accepted Answer

An **iterable** adalah apa saja yang boleh anda gelung (senarai, rentetan, dict); an **iterator** adalah objek yang melakukan lelaran sebenar, menghasilkan nilai satu demi satu dan menjejaki kedudukannya. Perbezaan ini mendasari cara `for` loops berfungsi dalam Python.

## Dua protokol

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

## Cara for loop benar-benar berfungsi

```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
```

A `for` loop memanggil `iter()` untuk mendapatkan iterator, kemudian berulang kali memanggil `next()` sehingga `StopIteration` menandakan akhir. Protokol inilah yang menjadikan setiap iterable dapat digelung.

## Iterable vs iterator dalam amalan

```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
```

Perbezaan utama: iterable (senarai) boleh digelung berkali-kali (setiap `for` mendapat iterator baru); iterator adalah **penggunaan tunggal** — sekali habis, ia kosong.

## Membina iterator tersuai

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

## Penjana adalah iterator

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

Penjana adalah cara mudah untuk membuat iterator — `yield` menangani jentera `__next__`/`StopIteration` untuk anda.

## Mengapa penting

Perbezaan iterable/iterator menjelaskan **bagaimana `for` loops berfungsi** dalam Python dan bagaimana lelaran disatukan di semua koleksi (senarai, dict, fail, penjana) melalui protokol iterator.

Memahaminya menjelaskan perilaku sebenar — mengapa iterator hanya boleh digunakan sekali (pepijat biasa: mengelung penjana/zip dua kali memberikan tiada apa-apa kali kedua), mengapa penjana adalah iterator, dan cara membuat objek anda sendiri iterable.

Protokal ini adalah asas model lelaran Python yang elegan dan konsisten, dan penting untuk bekerja dengan penjana, penilaian malas, dan kelas iterable tersuai.