lua_resume():第二个参数的含义是什么?

注意:下面有一些问题阐述了我的思路,但我要的只是标题中实际问题的答案。我不要求“一本书”,或者所有问题的条目化响应。

我正在尝试从C API启动协程,让其挂起,并在之后继续执行(可能是在执行其他协程的恢复之后)。这是一个相当简单的用例,但是lua_resume()的文档非常令人困惑:

int lua_resume(lua_State* L,lua_State* from,int nargs);

在给定的线程L中启动和恢复协程。

要启动协程,您需要将主函数以及任何参数推入线程堆栈,然后调用lua_resume,其中nargs是参数的数量。当协程挂起或完成其执行时,此调用将返回。当它返回时,堆栈包含通过lua_yield传递的所有值,或由body函数返回的所有值。lua_resume如果协程产生,LUA_OK如果协程在没有错误的情况下完成其执行,或者在出现错误时(请参见lua_pcall)返回错误代码。

在出现错误的情况下,堆栈不会展开,因此您可以在其上使用debug API。错误消息位于堆栈顶部。

要恢复协程,您需要从上一个lua_yield中删除任何结果,仅将要作为结果传递的值放到其堆栈上,然后调用lua_resume。

参数from表示正在恢复L的协程。如果没有这样的协程,则此参数可以为NULL。

这里“表示正在恢复L的协程” 的含义非常不清楚。什么时候“from”为空,Lfrom中的哪一个是“线程堆栈”,以及恢复协程的确切要求是什么?在初始的lua_resume()和实际恢复的第二个lua_resume()之间,状态L可以修改吗?如果可以,状态如何知道何时/在何处调用函数?如果不行(即一个lua_State一个线程),则创建一个新线程的正确方法是什么,以便它与父线程共享执行上下文(全局变量、环境等),在这种情况下调用lua_resume()并展开每个启动/恢复的呼叫的正确方法是什么?'from'参数可以与这些事情有何关系?

最后,在任一情况下,如何在错误处理程序中获取完整的堆栈跟踪(例如从lua_pcall的错误触发)以尊重/意识到调用跨越恢复?lua_getinfo()在恢复过程中正确报告吗?'from'参数是否就是这个目的?

我真的需要一个完整的、能够工作的从C API启动/恢复协程的示例,以说明那个第二个参数的用法。这里有一个gist上的示例,但它已经过时了,API也已经改变了——现在,lua_resume()需要三个参数,而不是两个……

点赞