python yield用法 (tornado, coroutine)

yield关键字用来定义生成器（Generator），其具体功能是能够当return使用，从函数里返回一个值，不一样之处是用yield返回以后，可让函数从上回yield返回的地点继续执行。也就是说，yield返回函数，交给调用者一个返回值，而后再“瞬移”回去，让函数继续运行， 直到吓一跳yield语句再返回一个新的值。

使用yield返回后，调用者实际获得的是一个迭代器对象，迭代器的值就是返回值，而调用该迭代器的next()方法会致使该函数恢复yield语句的执行环境继续往下跑，直到遇到下一个yield为止，若是遇不到yield，就会抛出异常表示迭代结束。

看一个例子：

>>> def test_yield():
...     yield 1
...     yield 2
...     yield (1,2)
...
>>> a = test_yield()
>>> a.next()
1
>>> a.next()
2
>>> a.next()
(1, 2)
>>> a.next()
Traceback (most recent call last):
  File "<stdin>", line 1, in ?
StopIteration

 

1. 包含yield的函数

假如你看到某个函数包含了yield，这意味着这个函数已是一个Generator，它的执行会和其余普通的函数有不少不一样。好比下面的简单的函数：

1. def h():  
2. print 'To be brave'  
3. yield 5  
4. h() 

能够看到，调用h()以后，print 语句并无执行！这就是yield，那么，如何让print 语句执行呢？这就是后面要讨论的问题，经过后面的讨论和学习，就会明白yield的工做原理了。

2. yield是一个表达式

Python2.5之前，Python yield是一个语句，但如今2.5中，yield是一个表达式(Expression)，好比：

1. m = yield 5 

表达式(yield 5)的返回值将赋值给m，因此，认为 m = 5 是错误的。那么如何获取(yield 5)的返回值呢？须要用到后面要介绍的send(msg)方法。

3. 透过next()语句看原理

如今，咱们来揭晓yield的工做原理。咱们知道，咱们上面的h()被调用后并无执行，由于它有yield表达式，所以，咱们经过next()语句让它执行。next()语句将恢复Generator执行，并直到下一个yield表达式处。好比：

1. def h():  
2. print 'Wen Chuan'  
3. yield 5  
4. print 'Fighting!'  
5. c = h()  
6. c.next()c.next() 

调用后，h()开始执行，直到遇到yield 5，所以输出结果：

1. Wen Chuan 

当咱们再次调用c.next()时，会继续执行，直到找到下一个yield表达式。因为后面没有Python yield了，所以会拋出异常：

1. Wen Chuan  
2. Fighting!  
3. Traceback (most recent call last):  
4. File "/home/evergreen/Codes/yidld.py", line 11, in <module> 
5. c.next()  
6. StopIteration 

4. send(msg) 与 next()

了解了next()如何让包含yield的函数执行后，咱们再来看另一个很是重要的函数send(msg)。其实next()和send()在必定意义上做用是类似的，区别是send()能够传递yield表达式的值进去，而next()不能传递特定的值，只能传递None进去。所以，咱们能够看作c.next() 和 c.send(None) 做用是同样的。来看这个例子：

1. def h():  
2. print 'Wen Chuan',  
3. m = yield 5 # Fighting!  
4. print m  
5. d = yield 12  
6. print 'We are together!'  
7. c = h()  
8. c.next() #至关于c.send(None)  
9. c.send('Fighting!') #(yield 5)表达式被赋予了'Fighting!'输出的结果为：  
10. Wen Chuan Fighting! 

须要提醒的是，第一次调用时，请使用next()语句或是send(None)，不能使用send发送一个非None的值，不然会出错的，由于没有Python yield语句来接收这个值。

5. send(msg) 与 next()的返回值

send(msg) 和 next()是有返回值的，它们的返回值很特殊，返回的是下一个yield表达式的参数。好比yield 5，则返回 5 。到这里，是否是明白了一些什么东西？本文第一个例子中，经过for i in alist 遍历 Generator，实际上是每次都调用了alist.Next()，而每次alist.Next()的返回值正是yield的参数，即咱们开始认为被压进去的东东。咱们再延续上面的例子：

1. def h():  
2. print 'Wen Chuan',  
3. m = yield 5 # Fighting!  
4. print m  
5. d = yield 12  
6. print 'We are together!'  
7. c = h()  
8. m = c.next() #m 获取了yield 5 的参数值 5  
9. d = c.send('Fighting!') #d 获取了yield 12 的参数值12  
10. print 'We will never forget the date', m, '.', d输出结果：  
11. Wen Chuan Fighting!  
12. We will never forget the date 5 . 12 

6. throw() 与 close()中断 Generator

中断Generator是一个很是灵活的技巧，能够经过throw抛出一个GeneratorExit异常来终止Generator。Close()方法做用是同样的，其实内部它是调用了throw(GeneratorExit)的。咱们看：

1. def close(self):  
2. try:  
3. self.throw(GeneratorExit)  
4. except (GeneratorExit, StopIteration):  
5. pass  
6. else:  
7. raise RuntimeError("generator ignored GeneratorExit")  
8. # Other exceptions are not caught 

所以，当咱们调用了close()方法后，再调用next()或是send(msg)的话会抛出一个异常：

1. Traceback (most recent call last):  
2. File "/home/evergreen/Codes/yidld.py", line 14, in <module> 
3. d = c.send('Fighting!') #d 获取了yield 12 的参数值12  
4. StopIteration