四、编程接口

这个部分描述了 Lua 的 C API ,也就是宿主程序跟 Lua 通讯用的一组 C 函数。 所有的 API 函数按相关的类型以及常量都声明在头文件lua.h 中。

虽然我们说的是“函数”,但一部分简单的 API 是以宏的形式提供的。 除非另有说明,所有的这些宏都只使用它们的参数一次 (除了第一个参数,那一定是 Lua 状态),因此你不需担心这些宏的展开会引起一些副作用。

C 库中所有的 Lua API 函数都不去检查参数是否相容及有效。然而,你可以在编译 Lua 时加上打开一个宏开关LUA_USE_APICHECK来改变这个行为。