# Generator function for the cube of numbers (power of 3)
def gencubes(n):
    for num in range(n):
        yield num**3

for x in gencubes(10):
    print x

"""
Explanation: Iterators and Generators
In this section of the course we will be learning about the difference between iteration and generation in Python and how to construct our own Generators with the yield statement. Generators allow us to generate as we go along, instead of holding everything in memory. 
We've touch on this topic in the past when discussing the range() function in Python 2 and the similar xrange(), with the difference being the xrange() was a generator.
Lets explore a little deep. We've learned how to create functions with def and the return statement. Generator functions allow us to write a function that can send back a value and then later resume to pick up where it left off. This type of function is a generator in Python, allowing us to generate a sequence of values over time. The main difference in syntax will be the use of a yield statement.
In most aspects, a generator function will appear very similar to a normal function. The main difference is when a generator function is compiled they become an object that support an iteration protocol. That means when they are called in your code the don't actually return a value and then exit, the generator functions will automatically suspend and resume their execution and state around the last point of value generation. The main advantage here is that instead of having to compute an entire series of values upfront and the generator functions can be suspended, this feature is known as state suspension.
￼￼To start getting a better understanding of generators, lets go ahead and see how we can create some.
End of explanation
"""


def genfibon(n):
    '''
    Generate a fibonnaci sequence up to n
    '''
    a = 1
    b = 1
    for i in range(n):
        yield a
        a,b = b,a+b

for num in genfibon(10):
    print num

"""
Explanation: Great! Now since we have a generator function we don't have to keep track of every single cube we created.
Generators are best for calculating large sets of results (particularly in calculations that involve loops themselves) in cases where we don’t want to allocate the memory for all of the results at the same time. 
As we've noted in previous lectures (such as range()) many Standard Library functions that return lists in Python 2 have been modified to return generators in Python 3 because generators.
Lets create another example generator which calculates fibonacci numbers:
End of explanation
"""


def fibon(n):
    a = 1
    b = 1
    output = []
    
    for i in range(n):
        output.append(a)
        a,b = b,a+b
        
    return output

fibon(10)

"""
Explanation: What is this was a normal function, what would it look like?
End of explanation
"""


def simple_gen():
    for x in range(3):
        yield x

# Assign simple_gen 
g = simple_gen()

print next(g)

print next(g)

print next(g)

print next(g)

"""
Explanation: Notice that if we call some huge value of n (like 100000) the second function will have to keep track of every single result, when in our case we actually only care about the previous result to generate the next one!
next() and iter() built-in functions
A key to fully understanding generators is the next function() and the iter() function.
The next function allows us to access the next element in a sequence. Lets check it out:
End of explanation
"""


s = 'hello'

#Iterate over string
for let in s:
    print let

"""
Explanation: After yielding all the values next() caused a StopIteration error. What this error informs us of is that all the values have been yielded. 
You might be wondering that why don’t we get this error while using a for loop? The for loop automatically catches this error and stops calling next. 
Lets go ahead and check out how to use iter(). You remember that strings are iterables:
End of explanation
"""


next(s)

"""
Explanation: But that doesn't mean the string itself is an iterator! We can check this with the next() function:
End of explanation
"""


s_iter = iter(s)

next(s_iter)

next(s_iter)

"""
Explanation: Interesting, this means that a string object supports iteration, but we can not directly iterate over it as we could with a generator function. The iter() function allows us to do just that!
End of explanation
"""


