6.2 – 协程管理

关于协程的操作作为基础库的一个子库,被放在一个独立表 coroutine 中。协程的介绍参见 §2.6


coroutine.create (f)

创建一个主体函数为 f 的新协程。f 必须是一个 Lua 的函数。返回这个新协程,它是一个类型为 "thread" 的对象。


coroutine.isyieldable ()

如果正在运行的协程可以让出,则返回真。

不在主线程中或不在一个无法让出的 C 函数中时,当前协程是可让出的。


coroutine.resume (co [, val1, ···])

开始或继续协程 co 的运行。当你第一次延续一个协程,它会从主体函数处开始运行。val1, … 这些值会以参数形式传入主体函数。如果该协程被让出,resume 会重新启动它;val1, … 这些参数会作为让出点的返回值。

如果协程运行起来没有错误,resume 返回 true 加上传给 yield 的所有值(当协程让出),或是主体函数的所有返回值(当协程中止)。如果有任何错误发生,resume 返回 false 加错误消息。


coroutine.running ()

返回当前正在运行的协程加一个布尔量。如果当前运行的协程是主线程,其为真。


coroutine.status (co)

以字符串形式返回协程 co 的状态:当协程正在运行(它就是调用 status 的那个) ,返回 "running";如果协程调用 yield 挂起或是还没有开始运行,返回 "suspended";如果协程是活动的,但并不在运行(即它正在延续其它协程),返回 "normal";如果协程运行完主体函数或因错误停止,返回 "dead"


coroutine.wrap (f)

创建一个主体函数为 f 的新协程。f 必须是一个 Lua 的函数。返回一个函数,每次调用该函数都会延续该协程。传给这个函数的参数都会作为 resume 的额外参数。和 resume 返回相同的值,只是没有第一个布尔量。如果发生任何错误,抛出这个错误。


coroutine.yield (···)

挂起正在调用的协程的执行。传递给 yield 的参数都会转为 resume 的额外返回值。