Cad é an difríochtaí idir iterable agus iterator?

Question

Accepted Answer

Is é an **iterable** rud ar bith ar féidir leat a lúbadh tríd (liosta, teanga, dict); is é an **iterator** an réad a dhéanann an atriall iarbhír, agus luachanna á dtáirgeadh ceann ar a chéile agus a shuíomh á rianú. Tá an idirdhealú seo bunaithe ar an chaoi ar oibríonn `for` braitheanna i Python.

## An dá bhóthar

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

## Conas a oibríonn braithin for i ndáiríre

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

Glaonn braithin `for` ar `iter()` chun iterator a fháil, ansin glaonn sé ar `next()` go rialta go dtí go dtugann `StopIteration` an deireadh in iúl. Is é an protocol seo a dhéanann aon iterable inlúbtha.

## Iterable vs iterator san fheidhmiúchán

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

Príomh-dhifríochtaí: is féidir iterable (liosta) a lúbadh go leor uaireanta (faigheann gach `for` iterator nua); is é iterator **single-use** — nuair a bhíonn sé ídithe, tá sé folamh.

## Ag tógáil iterator saincheaptha

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

## Gineadóirí iad iterators

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

Is é an bealach éasca é gineadóirí a chruthú iterators — bainistríonn `yield` an mheaisíméadracht `__next__`/`StopIteration` duit.

## Cén fáth a bhíonn sé i gceist

Míníonn an idirdhealú iterable/iterator **conas a oibríonn `for` braitheanna** i Python agus conas a bhíonn atriall aontaithe ar fud gach cnuasach (liostaí, dicts, comhaid, gineadóirí) tríd an iterator protocol.

Ag tuiscint air soilsíonn sé iompar fíor — cén fáth nach féidir iterator ach a dhíoladh uair amháin (fabht choitianta: ag lúbadh gineadóir/zip faoi dhó tugann sé a dhada an dara huair), cén fáth gur iterators iad gineadóirí, agus conas d'fhéadfadh tú do réada féin inlúbtha a dhéanamh.

Is é an protocol seo bunús an mhúnla atriall galánta, comhsheasmhach Python agus is ríthábhachtach é do dhul i mbun gineadóirí, meastóireacht dhána, agus ranganna inlúbtha saincheaptha.