Python Yield versus Return

As coders, we are familiar with how function calls work in Python or C.  Whenever we call a function, the function gets a private namespace where its local variables are created.

Return

The return statement is where all the local variables are destroyed and the resulting value is given back (returned) to the caller.  Should the same function be called some time later, the function will get a fresh new set of variables.

Yield

But what if the local variables aren't thrown away when we exit a function?  This implies that we can resume the function where we left off.  This is where the concept of generators are introduced and the yield statement resumes where the function left off.

Here's a simple example:

def generate_integers(N):
    for i in range(N):
        yield i

So here's what actually happens and we can observe this in our python (or ipython) shell:

In [1]:  gen = generate_integers(3)
In [2]:  gen
<generator object at 0x8117f90>
In [3]:  gen.next()
0 
In [4]:  gen.next()
1
In [5]:  gen.next()
2

So that's the difference between return and yield statements in Python.  yield statement is what makes a function a generator function.