Question

程序开发中接口类函数有哪些？

Answer 1

这个函数等价于调用 lu a_yieldk， 不同的是不提供延续函数（参见。 因此，当线程被延续，线程会继续运行调用 l ua_yield 函数的函数。
让出协程（线程）。
当 C 函数调用了 lu a_yieldk， 当前运行的协程会挂起， 启动这个线程的 l ua_resume 调用返回。 参数 nresults 指栈上需返回给 l ua_resume 的返回值的个数。
当协程再次被延续时， L ua 调用延续函数 k 继续运行被挂起（参见）的 C 函数。 延续函数会从前一个函数中接收到相同的栈， 栈中的 n 个返回值被移除而压入了从 lu a_resume 传入的参数。 此外，延续函数还会收到传给 lu a_yieldk 的参数 ctx。
通常，这个函数不会返回； 当协程一次次延续，将从延续函数继续运行。 然而，有一个例外： 当这个函数从一个逐行运行的钩子函数（参见） 中调用时，lu a_yieldk 不可以提供延续函数。 （也就是类似 l ua_yield 的形式）， 而此时，钩子函数在调用完让出后将立刻返回。 L ua 会使协程让出，一旦协程再次被延续， 触发钩子的函数会继续正常运行。
当一个线程处于未提供延续函数的 C 调用中，调用它会抛出一个错误。 从并非用延续方式（例如：主线程）启动的线程中调用它也会这样。
l ua_getinfo
int lua_getinfo (lua_State *L, const char *what, lua_Debug *ar);
返回一个指定的函数或函数调用的信息。
当用于取得一次函数调用的信息时， 参数 ar 必须是一个有效的活动的记录。 这条记录可以是前一次调用 lu a_getstack 得到的， 或是一个钩子 （参见 ）得到的参数。
用于获取一个函数的信息时， 可以把这个函数压入堆栈， 然后把 what 字符串以字符 '>' 起头。 （这会让 l ua_getinfo 从栈顶上弹出函数。） 例如，想知道函数 f 是在哪一行定义的， 你可以使用下列代码：
lu a_getlocal
const char *lu a_getlocal (lua_State *L, const lua_Debug *ar, int n);
从给定活动记录或从一个函数中获取一个局部变量的信息。
对于第一种情况， 参数 ar 必须是一个有效的活动的记录。 这条记录可以是前一次调用 lua_getstack 得到的， 或是一个钩子 （参见）的参数。 索引 n 用于选择要检阅哪个局部变量； 参见 debug.getlocal 中关于变量的索引和名字的介绍。
lu a_getlocal 将变量的值压栈，并返回其名字。
对于第二种情况，ar 必须填 NULL 。 需要探知的函数必须放在栈顶。 对于这种情况，只有 Lua 函数的形参是可见的 （没有关于还有哪些活动变量的信息） 也不会有任何值压栈。
当索引大于活动的局部变量的数量， 返回 NULL （无任何压栈）
lu a_getstack
int lu a_getstack (lua_State *L, int level, lua_Debug *ar);
获取解释器的运行时栈的信息。
这个函数用正在运行中的指定层次处函数的 活动记录 来填写 lu a_Debug 结构的一部分。 0 层表示当前运行的函数， n+1 层的函数就是调用第 n 层 （尾调用例外，它不算在栈层次中） 函数的那一个。 如果没有错误， lua_getstack 返回 1 ； 当调用传入的层次大于堆栈深度的时候，返回 0 。