创建一个协程（thread 类型），参数 f 是协程体函数。创建后处于 suspended 状态，用 resume 启动。

协程（thread）

local co = coroutine.create(function(a, b)
    print(a + b)
end)
print(type(co))        --> thread
coroutine.resume(co, 1, 2)   --> 3

启动/继续执行协程 co，参数会传给协程体（首次）或上一次 yield 的返回点。协程内出错不会中断主程序，而是通过返回值报告。

成功: true + 协程 yield/结束的值；出错: false + 错误信息

local co = coroutine.create(function()
    coroutine.yield('第一步')
    return '完成'
end)
print(coroutine.resume(co))   --> true  第一步
print(coroutine.resume(co))   --> true  完成

返回当前正在运行的协程。主线程中 5.1 返回 nil，5.2+ 返回主协程和 true。

无参数

当前协程（thread）；主线程中 5.1 返回 nil

print(coroutine.running())   --> nil（主线程, Lua 5.1）

返回协程状态："running"（正在运行）、"suspended"（挂起）、"normal"（唤醒了别的协程）、"dead"（已结束）。

状态字符串

local co = coroutine.create(function() coroutine.yield() end)
print(coroutine.status(co))   --> suspended
coroutine.resume(co)
print(coroutine.status(co))   --> suspended
coroutine.resume(co)
print(coroutine.status(co))   --> dead

创建协程并返回一个迭代/调用函数：每次调用它等于 resume 一次，直接返回协程的值（出错时直接抛错，不通过返回值）。

可重复调用的函数

local gen = coroutine.wrap(function()
    for i = 1, 3 do coroutine.yield(i * 10) end
end)
print(gen())   --> 10
print(gen())   --> 20
print(gen())   --> 30

挂起当前协程，把参数交回给 resume 的调用方；下次 resume 时传入的参数成为 yield 的返回值。协程的“暂停键”。

下次 resume 传入的参数

local co = coroutine.create(function()
    local x = coroutine.yield(1)
    print('收到', x)
end)
coroutine.resume(co)
coroutine.resume(co, '数据')   --> 收到 数据