Cila është ndryshimi midis një iterable dhe një iterator?

Question

Accepted Answer

Një **iterable** është gjithçka që mund të përsëritni (një listë, string, dict); një **iterator** është objekti që kryen përsëritjen aktuale, prodhon vlera një e nga një dhe ndjek pozicionin e tij. Kjo dallim qëndron në themel të mënyrës sesi funksionojnë `for` sythe në Python.

## Dy protokollet

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

## Si funksionon vërtet një for sythë

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

Një `for` sythë thërret `iter()` për të marrë një iterator, pastaj thërret `next()` në mënyrë të përsëritur derisa `StopIteration` të sinjalizojë fundin. Ky protokoll është ajo që e bën çdo iterable të përsëritshëm.

## Iterable kundër iterator në praktikë

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

Ndryshimi kryesor: një iterable (listë) mund të përsëritet shumë herë (secila `for` merr një iterator të freskët); një iterator është **përdorim i vetëm** — pasi të jetë shteruar, është boshe.

## Ndërtimi i një iterator custom

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

## Gjeneratorët janë iteratorë

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

Gjeneratorët janë mënyra e lehtë për të krijuar iteratorë — `yield` menaxhon mekanikën `__next__`/`StopIteration` për ju.

## Pse kjo ka rëndësi

Ndryshimi midis iterable dhe iterator shpjegon **si funksionojnë `for` sythe** në Python dhe si iteracija është e unifikuar në të gjitha koleksionet (lista, dicts, skedarë, gjeneratorë) përmes protokollit iterator.

Kuptuesi i kësaj qartëson sjelljët reale — pse një iterator mund të konsumohet vetëm një herë (një gabim i zakonshëm: përsëritja e një gjeneratori/zip dy herë nuk jep asgjë herën e dytë), pse gjeneratorët janë iteratorë dhe si të bëni objektet tuaja iterable.

Ky protokoll është themeli i modelit të elegantë dhe të qëndrueshëm të iterimit të Python dhe është thelbësor për të punuar me gjeneratorë, vlerësimin dembel dhe klasat iterable të personalizuara.