计算机中程序接口类函数有哪些？

1.1 这个函数等价于调用 lu a_yieldk， 不同的是不提供延续函数（参见。 因此，当线程被延续，线程会继续运行调用 l ua_yield 函数的函数。

让出协程（线程）。

1.2 当 C 函数调用了 lu a_yieldk， 当前运行的协程会挂起， 启动这个线程的 l ua_resume 调用返回。 参数 nresults 指栈上需返回给 l ua_resume 的返回值的个数。

当协程再次被延续时， L ua 调用延续函数 k 继续运行被挂起（参见）的 C 函数。 延续函数会从前一个函数中接收到相同的栈， 栈中的 n 个返回值被移除而压入了从 lu a_resume 传入的参数。 此外，延续函数还会收到传给 lu a_yieldk 的参数 ctx。

1.3 通常，这个函数不会返回； 当协程一次次延续，将从延续函数继续运行。 然而，有一个例外： 当这个函数从一个逐行运行的钩子函数（参见） 中调用时，lu a_yieldk 不可以提供延续函数。 （也就是类似 l ua_yield 的形式）， 而此时，钩子函数在调用完让出后将立刻返回。 L ua 会使协程让出，一旦协程再次被延续， 触发钩子的函数会继续正常运行。

1.4 当一个线程处于未提供延续函数的 C 调用中，调用它会抛出一个错误。 从并非用延续方式（例如：主线程）启动的线程中调用它也会这样。

l ua_getinfo

int lua_getinfo (lua_State *L, const char *what, lua_Debug *ar)

返回一个指定的函数或函数调用的信息。

1.5 当用于取得一次函数调用的信息时， 参数 ar 必须是一个有效的活动的记录。 这条记录可以是前一次调用 lu a_getstack 得到的， 或是一个钩子 （参见 ）得到的参数。

用于获取一个函数的信息时， 可以把这个函数压入堆栈， 然后把 what 字符串以字符 '>' 起头。 （这会让 l ua_getinfo 从栈顶上d出函数。） 例如，想知道函数 f 是在哪一行定义的， 你可以使用下列代码：

lu a_getlocal

const char *lu a_getlocal (lua_State *L, const lua_Debug *ar, int n)

1.6 从给定活动记录或从一个函数中获取一个局部变量的信息。

对于第一种情况， 参数 ar 必须是一个有效的活动的记录。 这条记录可以是前一次调用 lua_getstack 得到的， 或是一个钩子 （参见）的参数。 索引 n 用于选择要检阅哪个局部变量； 参见 debug.getlocal 中关于变量的索引和名字的介绍。

lu a_getlocal 将变量的值压栈，并返回其名字。

1.7 对于第二种情况，ar 必须填 NULL 。 需要探知的函数必须放在栈顶。 对于这种情况，只有 Lua 函数的形参是可见的 （没有关于还有哪些活动变量的信息） 也不会有任何值压栈。

当索引大于活动的局部变量的数量， 返回 NULL （无任何压栈）

lu a_getstack

int lu a_getstack (lua_State *L, int level, lua_Debug *ar)

获取解释器的运行时栈的信息。

1.8 这个函数用正在运行中的指定层次处函数的 活动记录 来填写 lu a_Debug 结构的一部分。 0 层表示当前运行的函数， n+1 层的函数就是调用第 n 层 （尾调用例外，它不算在栈层次中） 函数的那一个。 如果没有错误， lua_getstack 返回 1 ； 当调用传入的层次大于堆栈深度的时候，返回 0 。

1、库函数：是由C语言系统提供的函数，这类函数用户可以直接在程序中调用，从而完成一定的功能，这类函数也被称为“标准函数”。

2、用户自定义函数：是由用户在程序中定义的函数，是由用户根据应用程序的需要而定义、用以完成特定功能的程序模块。

---