Python iter() Method – [With Examples]

In this tutorial we will learn about the python iter() method and its uses with examples.

Python iter() Method

What is Python iter() Method?

The iter() is a Python built-in method that returns an iterator for the given object.

The syntax of the iter() method is:

iter(object, sentinel)

Python iter() Method Parameters

The iter() methods take two parameters as an argument:

  • object – the name of the object whose iterator has to be returned.
  • sentinel (optional) –  A numeric value that is used to represent the end of the sequence.

Let’s check some examples of the python iter() method.

Example 1: How to use the iter() method in python?

cars = [‘BMW’,‘AUDI’,‘FORD’]
My_iter = iter(cars)
print(next(My_iter)) # BMW
print(next(My_iter)) # AUDI
print(next(My_iter)) # FORD


<list_iterator object=“” at=“” 0x7fddb59cb820=“”>
<class ‘list_iterator’=“”>

We can use the next() method to print the elements of iteration, and the iteration will remember the next count via the internal count variable. Once the iteration is complete, it raises a StopIteration exception, and the iteration count cannot be reassigned to 0.

We can also use __next__() method with ithe ter() method to print the iterator.

Example 2: Using __next__() method in python iter() method.

cars = [‘BMW’,‘AUDI’,‘FORD’]
My_iter = iter(cars)
print(My_iter.__next__()) # BMW
print(My_iter.__next__()) # AUDI
print(My_iter.__next__()) # FORD

The output will be as follows.


Example 3: Using iter() with custom objects.

class PrintNumber:
def __init__(self, max):
self.max = max
def __iter__(self):
self.num = 0
return self
def __next__(self):
if(self.num >= self.max):
raise StopIteration
self.num += 1
return self.num
print_num = PrintNumber(3)
print_num_iter = iter(print_num)
print(next(print_num_iter)) # 1
print(next(print_num_iter)) # 2
print(next(print_num_iter)) # 3
# raises StopIteration

The output will be as follows.

Traceback (most recent call last):
File “”, line 23, in <module>
File “”, line 11, in __next__
raise StopIteration

Rules of iter()

  • If the user-defined object doesn’t implement __iter__(), and __next__() or __getitem()__, the TypeError exception is raised.
  • If the sentinel parameter is also provided, iter() returns an iterator until the sentinel character isn’t found.