In this article we will discuss what’s the use of yield keyword, What are generators and how to Iterate over Generator objects.

Yield Keyword

In Python inside a function instead of using return keyword, we can use yield keyword to return the value. But unlike return keyword, the yield keyword do not terminates the function, it just pauses the function by saving its current state like last executed line number, variables on stack and then it returns the yielded value. So, now next time when this function will be called, then it will start from the point it left off. If there is no value to yield and function reaches its end then StopIteration is raised. Otherwise if any another yield is encountered then it will again pause the function execution and returns the yielded value.

Let’s understand by an example,

A function can yield multiple values at different locations inside a function i.e.

Generator Function & yield keyword

The function that uses yield keyword is called Generator function. Because if we call this function it returns a Generator object ( which internally has control over the generating function)


A generator object is a kind of Iterator, on which we can call the next() function to fetch the next yielded value from the associated function i.e.

Now when first time we call the next() function on this Generator object, then it calls the associated generator function ( primeNumbers() in our case). primeNumbers() function is executed from start. As soon as it encounters a yield statement, execution is paused and yielded value is returned i.e.

Now when second time we call the next() function on Generator object, then it calls the primeNumbers() again. But this time primeNumbers() function starts from the point where it was last paused. As soon as it encounters another yield statement, it pauses the execution and returns the value i.e


Similarly when we call the next() function third time then function primeNumbers() continues from the last paused location. Then it continues till it encounters any yield statement. As there is no more yield statement and function end is reached, therefore StopIteration is raised i.e.


As no more yield statement was found and function terminated, therefore it raised the StopIteration.

Iterate over Generator object Using while loop & next() function

Now instead of calling next() function on generator object one by one, we can use while loop too i.e.


Using generator with For loop

A generator function yields multiple values and returns an Generator object. We can Iterate over this yielded values of generator function by
using the returned Generator object. This Generator object is an Iterator and can be used at any place where Iterator can be used like for loop.

As primeNumbers() returns a Generator, so we can for loop over this Generator object to fetch all the yielded values
from generator function primeNumbers() one by one i.e.


for loop internally calls the next() function on returned Generator object and also handles the StopIteration.

Another example:

Let’s create a function that accepts a string and yields every alternate character in the given string i.e.

This function returns a Generator object and we can use this generate object to iterate over every alternate character of the given string i.e.


Now we hope that you understand what is the use of yield keyword, Generator Function & Generator objects.

But why do we need Generators ?

Memory Efficient

Generators help us implement memory efficient solutions. Many times we want to do some processing on a collection of elements but on one element at a time. For such scenarios don’t need to create huge list or set, we can use generators to iterate over the elements one at a time.

Infinite Generators

Many times we want to generate stuff continuously, like continuous monitoring of memory usage etc. For these kind of purposes we can create Infinite Generators. Infinite generator is a kind of generator that will keep on returning values and never raises a Stop Iteration.
For example, we want a generator that should keep on returning values from 0 to 4 in a cycle i.e.

Now we loop through this generator object then it will continously return values and never raises StopIteration i.e.


It will keep on printing numbers 0 to 4 in a loop.

Complete example is as follows:



If you didn't find what you were looking, then do suggest us in the comments below. We will be more than happy to add that.

Do Subscribe with us for more Articles / Tutorials like this,