Есть два разных понятия: итератор (iterator), итерируемый объект (iterable). У них есть схожие черты (и по тому, и по другому можно пройтись циклом), но есть большая разница.
С точки зрения реализации:
итерируемый объект должен реализовать метод __iter__
, из которого должен возвращаться итератор (но не другой итерируемый объект). В идеале - при каждом вызове новый итератор.
итератор должен реализовывать и метод __iter__
(который должен возвращать сам объект (self
)), и метод __next__
, который при каждом вызове должен возвращать следующее значение из итератора (или выбрасывает исключение StopIteration
).
Чисто технически, каждый итератор можно считать итерируемым объектом - у каждого итератора реализован __iter__
(который, правда, не создает новый итератор). Но не наоборот - не у каждого итерируемого объекта будет метод __next__
. Поэтому и не работает возврат list
из __iter__
- он является итерируемым объектом, но не итератором.
С точки зрения поведения:
После того как итератор создан, по нему можно пройти циклом (или, например, извлекать значения с помощью функции next
) только один раз, при попытке пройти повторно итератор больше не возвращает никаких значений - так называемое исчерпание итератора (iterator exhaustion)
По итерируемому объекту (кроме итераторов) можно итерироваться много раз - его метод __iter__
каждый раз возвращает новый итератор.
Хотя итератор формально (по наличию метода __iter__
) можно считать итерируемым объектом, но __iter__
у него не создает новый итератор, а просто возвращает сам объект, по которому уже нельзя пройти повторно, если он исчерпан.
По вашему коду:
- В принципе, если реализуете итератор, лучше не добавлять в
__iter__
никакого кода, кроме return self
, а всю инициализацию делать в __init__
.
__next__
должен именно возвращать значения через return
, а не через yield
. Если добавляете в функцию yield, то она магически становится генератором, который возвращает итератор (generator iterator, частный случай итератора), а вам нужно ровно одно значение, а не новый итератор.
Таким образом, класс-итератор в идеале должен выглядеть так:
class Test():
def __init__(self, name, age):
self.name = name
self.age = age
self.index = -1
self.list_q = [self.name, self.age]
def __iter__(self):
return self
def __next__(self):
self.index += 1
if self.index >= len(self.list_q):
raise StopIteration
return self.list_q[self.index]
Если вы реализуете итерируемый объект, то метод __next__
не нужен, но __iter__
должен вернуть итератор. Из списка можно получить итератор передав его в функцию iter
:
class Test():
def __init__(self, name, age):
self.name = name
self.age = age
self.list_q = [self.name, self.age]
def __iter__(self):
return iter(self.list_q)
t = Test('Имя', 10)
for item in t:
print(item)
Либо можно использовать yield
(как я уже писал выше, в этом случае функция превратится в генератор и будет возвращать итератор):
class Test():
def __init__(self, name, age):
self.name = name
self.age = age
self.list_q = [self.name, self.age]
def __iter__(self):
for item in self.list_q:
yield item
t = Test('Имя', 10)
for item in t:
print(item)
Еще один способ - использовать выражение-генератор (generator expresson), оно также является итератором:
class Test():
def __init__(self, name, age):
self.name = name
self.age = age
self.list_q = [self.name, self.age]
def __iter__(self):
return (item for item in self.list_q)
t = Test('Имя', 10)
for item in t:
print(item)
iter(self.list_q)
. Отличие итерируемого объекта от итератора в том, что у него__iter__
возвращает итератор, но у самого итерируемого объекта метод__next__
не реализован.__iter__
, из которого должен вернуться итератор. У итератора должен быть метод__next__
, чтобы дальше получать значения из этого объекта. Но вы возвращаете список, у списка нет метода__next__
, потому что он не итератор (буквально: попытка вызова__next__
от списка выдастAttributeError
). Python правда это отлавливает на более раннем этапе, и сразу человеческим языком пишет, что list - не итератор.__next__
- это хорошее объяснение, это я и пропустил как-раз.