python中和生成器协程相关的yield之最详最强解释，一看就懂（一）

yield是python中一个非常重要的关键词，所有迭代器都是yield实现的，学习python，如果不把这个yield的意思和用法彻底搞清楚，学习python的生成器，协程和异步io的时候，就会彻底懵逼。所以写一篇总结讲讲yield的东西。

分成四块来讲， 这篇先说yield基本用法，后面会重点将yield from的牛逼之处

一， 生成器中使用yield

语法形式：yield <表达式>

这种情况，可以简单的把它理解为 return <表达式>， 每次next调用，会触发生成器从上一次停止的地方开始执行， 直到下一次遇到yield。 如果是第一次next，就是那个从函数开始知道第一个yield；以后每次next，则都是从上次yiled停止的地方开始， 继续执行，直到遇到下一次yiled， 如果一直执行到函数结束，都没有下个yield遇到， 则生成器运行终止，此时next会在生成器运行终止时，抛出StopIteration异常。 比如下面的代码

 def generator():
     print("gen-0:    start")
     for i in range(2):
         print("gen-%s-a:    i=%s" % (i,i))
         yield i + 1                          # 可简单理解为 return i + 1, 并等待
         print("gen-%s-b:    i=%s" % (i,i))
     print("gen-c")
     yield 3                                  # 可简单理解为 return 3, 并等待
     print("gen-d")                           # 此处继续执行完成后，由于后续在无其它yield语句，调用next的代码会抛出StopIteration异常

 try:
     g = generator()                          # 由于generator是一个包含yield关键字的生成器，此处直接调用gengerator（）只是返回该生成器实例，实际无任何输出
     print('main-0:    start')
     n = next(g)                              # next触发生成器执行，由于是第一次触发，所以从generator循环外第2行和第4行的打印会输出，到第5行遇到yield后返回i+1到主程序，第6行不会执行
     print('main-1:    n=%s' % n)
     n = next(g)                              # next第二次触发生成器执行，由于是第二次触发，上次执行到第5行， 此时从第6行开始执行, 将输出第6行和第4行的打印， 并再次在第5行返回
     print('main-2:    n=%s' % n)
     n = next(g)                              # next第三次触发生成器执行，这次generator内部for循环已经完成，故执行完跳出循环执行到第8行后返回
     print('main-3:    n=%s' % n)
     n = next(g)                              # next视图第四次触发生成器执行，从第9行开始执行，但此后generator已经全部执行完成，所以此时next会抛出StopIteration异常，赋值无法完成
     print('main-5:    n=%s' % n)             # 异常产生， 此行将永远不会被执行
 except StopIteration:
     print('StopIteration n=%s' % n)          # 第17行的next将触发异常

上面这段代码执行输出如下， 各位看官自行对照代码和详细注释很容易看懂

main-0: start
gen-0: start
gen-0-a: i=0
main-1: n=1
gen-0-b: i=0
gen-1-a: i=1
main-2: n=2
gen-1-b: i=1
gen-c
main-3: n=3
gen-d
StopIteration n=3

二， 可以接收传入参数值的yield

语法形式：x = yield <表达式>

next方式触发生成器无法传入参数， 如果想触发generator的同时， 传入参数给生成器，是否可以喃？答案是可以的， 这时候需要做两个改变，一是在生成器内增加变量接收该参数， 即本届标题形式；二是外部调用时， 不使用next， 而采用用调用生成器的send方法即可

 def coroutine():                                    # 这个生成器，我们其名coroutine, 意思是协程，协程和生成器都是使用yield来实现， 但本质上不一个概念
     print("coroutine:    start")
     for i in range(2):
         print("coroutine-a:    i=%s" % i)
         x = yield i + 1                                # 由send传入的参数值将被赋值给x, 注意i+1的值是被yield用来返回的，不会赋值给x ！
         print("coroutine-b:    i=%s, x=%s" % (i,x))

 cr = coroutine()                                    # 创建一个生成器实例
 next(cr)                                            # 生成器的第一次触发必须使用next，此时如果试图用send发送参数，将导致异常败，原因是此时生成器还未启动
 try:
     print("main-a:")
     y = cr.send(0)                                # 调用生成器的send方法， 将10传给生成器， 并触发一次生成器的执行
     print("main-b:        y=%s" % y)
     y = cr.send(1)                                # 调用生成器的send方法， 将1传给生成器， 并触发一次生成器的执行
     print("main-c:        y=%s" % y)                # 14行的消息发送将导致StopIteration异常产生， 此行将永远不会被执行
 except StopIteration:
     print("StopIteration")

以下是执行后的输出

coroutine:      start
coroutine-a:    i=0
main-a:
coroutine-b:    i=0, x=0
coroutine-a:    i=1
main-b:         y=2
coroutine-b:    i=1, x=1
StopIteration

简单再解释一下，

1. 第一次执行next时，生成器通过yield i + 1 返回1, 并停在第5行等待被唤醒， 此时赋值动作尚未发生， x的值只是个None， 同时也为执行后面的print。

2. 生成器通过next进行过首次触发后，可以用send发送参数，比如第11行和12行，生成器内部变量先分别被赋值为 0和1， 大家可以对照输出看

3. 由于生成器总共只有两次yield的机会， next消耗一次，第一次send消耗一次，所以第二次send后，虽然不影响执行完参数传递给生成器的动作， 但由于生成器自身找不下一次yield的机会，生成器执行终止。 导致send抛出StopIteration异常

三。生成器本身的返回值

不知道大家注意到没有， 直接类似的cr = coroutine()   的调用，只是产生一个生成器实例，并没执行。而通过yield的返回时， 生成器本身的逻辑实际上都是为走完的， yield英文是退让的意思，除了无限序列的生成器，生成器最终都会执行完成，那么此时如果生成器通过return正常返回一个值，生成器的使用者能获得吗 ？比如下面的代码， 生成器正常结束后return的代码， 使用方如何获得喃 ？比如下面代码如何获取第10行正常终止后的返回值10

 def generator():
     yield 5
     return 10                    # 这个返回值如何获得 ？

 cr = generator()
 n = next(cr)                     # yield 5返回的值可以被获得并赋值给n

答案是在StopIteration异常的处理逻辑中可以获得，方法如下， 只需要在上面代码后面继续加上以下处理

try:
    next(cr)
except StopIteration as e:        # 通过except ... as 将异常保存在变量e中
    rt = e.value                # 异常变量e的value值就是生成器通过return返回值

严格意义上讲， python将StopIteration定义为一个异常可能是不得已的事情， 因为这个异常的意思， 实际就是告诉使用者， “我没发生成下一个了， yield次数已经用完了， 我的使命结束了”， 从这个意义上讲， StopIteration也可以归为是正常逻辑， 所以强烈建议所有使用用生成器的地方，都应该要加上StopIteration异常处理。

四，不用next触发生成器执行

生成器的首次触发一定要使用next或者send(None)触发，这个有时候比较麻烦， 有没有不需要写next的情况喃。 答案是肯定的。我们可以把generator放在循环里面，比如把第一个例子的几次next改成一个for循环

def generator():
    print("gen-0:    start")
    for i in range(2):
        yield i + 1
    yield 3                                 

try:
    g = generator()
    for n in g:                            # for循环是通过next触发生成器实现的， 内部会调用next(g)
        print(n)
except StopIteration:
    print('StopIteration n=%s' % n)                

将得到下面的输出, 因为在python里面所有的迭代，包括循环语句，实际底层的实现都是通过生成器搞定的， 所以在for循环里面， 实际上是python内部实现在帮你调用next来触发生成器.和我们在第一例中的显示依次调用next(g)是一样的 可以看到第一次打印了“start”输出， 后面依次输出1，2，3. 但没有StopExeption抛出， 那是因为for的语意是循环次数和实际相同， 所以最后一次next被for内部消化了， 没有暴露出来而已

gen-0:  start
1
2
3

四。 再说 x = yield i, 生成器和协程

我们在来看一下上面第二部分的例子， 这里的x = yield i + 1语句, 实际上使函数本身同时具备了生产者和消费的功能， yield i + 1会让每次执行产生一个值， 这是生成者，而 x = yiled又让它可以接收一个send所发送的值。这样看起来同时具备了双重功能， 但这却是一种不好的用法， 应该尽量避免。而是让一个函数功能单一， 要吗作为生产器，要吗作为仅具备消费功能的协程。虽然协程和生成器都是用yield来实现的， 但不应该将二者功能混淆， 这可能会导致一些难以理解的代码，是不推荐这么用的。 推荐的用发是分开，要吗作为生成器，要吗作为协程，不要让一个函数同时兼备二者的功能

第一节是作为生成器的例子

作为协程， 建议的方式是使用  x = (yield), 不要让yiled生成任何值， 仅仅用于接收

 def coroutine():                                    # 这个是协程,消费每次收到的值
     print("coroutine:    start")
     While True:
          print("coroutine-a:    i=%s" % i)
          x = (yield)
          print("coroutine-b:    x=%s" % x)

下一篇 ： python中和生成器协程相关的yield from之最详最强解释，一看就懂（二）