Lua常用C Api接口

Lua 5.4 是 Lua 语言的一个版本，它提供了许多 C API 函数，这些函数允许开发者在 C 语言中嵌入和扩展 Lua 的功能。以下是一些常用的 Lua 5.4 C API 函数，以及它们的简单示例：

1. lua_newstate - 创建一个新的 Lua 状态。

   lua_State *L = lua_newstate(0, 0); // 创建一个新的 Lua 状态
   

2. lua_close - 关闭一个 Lua 状态。

   lua_close(L); // 关闭 Lua 状态
   

3. lua_openlibs - 打开 Lua 的标准库。

   lua_openlibs(L); // 打开所有标准库
   

4. lua_getglobal - 获取全局变量。

   lua_getglobal(L, "myGlobal"); // 获取名为 'myGlobal' 的全局变量
   

5. lua_setglobal - 设置全局变量。

   lua_pushnumber(L, 42); // 将数字 42 推入栈
   lua_setglobal(L, "myGlobal"); // 将栈顶的值设置为全局变量 'myGlobal'
   

6. lua_pcall - 调用一个函数。

   int status = lua_pcall(L, 0, LUA_MULTRET, 0); // 调用栈顶的函数
   if (status != LUA_OK) {
       // 处理错误
   }
   

7. lua_pushnumber - 将一个数字推入栈。

   lua_pushnumber(L, 123); // 将数字 123 推入栈
   

8. lua_pushstring - 将一个字符串推入栈。

   const char *str = "Hello, Lua!";
   lua_pushstring(L, str); // 将字符串 "Hello, Lua!" 推入栈
   

9. lua_pushboolean - 将一个布尔值推入栈。

   lua_pushboolean(L, 1); // 将真值推入栈
   

10. lua_pushnil - 将 nil 推入栈。

    lua_pushnil(L); // 将 nil 推入栈
    

11. lua_pop - 从栈中弹出元素。

    lua_pop(L, 1); // 从栈中弹出一个元素
    

12. lua_newtable - 创建一个新的空表。

    lua_newtable(L); // 创建一个新的空表
    

13. lua_settable - 将一个值设置到表中。

    lua_pushstring(L, "key"); // 推入键
    lua_pushnumber(L, 123); // 推入值
    lua_settable(L, -3); // 将值设置到表中，表在栈的 -3 位置
    

14. lua_gettop - 获取栈顶的索引。

    int top = lua_gettop(L); // 获取栈顶索引
    

15. lua_settop - 设置栈的顶部。

    lua_settop(L, 0); // 将栈顶设置为 0
    

16. lua_load - 加载一个 Lua 脚本。

    int status = lua_load(L, my_reader, data, "script.lua");
    if (status != LUA_OK) {
        // 处理错误
    }
    

17. lua_register - 注册 C 函数到 Lua 中。

    lua_register(L, "myCFunction", myCFunction); // 注册 C 函数