Lua Academy · 课时

Lua C API 的栈模型

Q: 「Lua C API 的栈模型」这节课中我会学到什么？

理解 Lua 栈、索引以及基本的入栈和出栈操作。 你通过在浏览器中直接运行的动手代码来练习 Lua Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

理解 Lua 栈、索引以及基本的入栈和出栈操作。

Lua C API 的栈模型 是 CoddyKit 上的免费 Lua Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Lua Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Lua Academy 课程共包含 4 节课。

为什么使用 C API？

Lua 可以嵌入 C/C++ 应用程序。宿主 C 代码创建 Lua 状态、加载脚本、调用 Lua 函数，并向 Lua 暴露 C 函数——这一切都通过 Lua C API 完成。

Lua 栈

Lua C API 通过虚拟栈进行通信。C 代码在调用前将值压入栈中，并在调用后从栈中读取返回值。

创建 Lua 状态

luaL_newstate() 创建一个新的 Lua 解释器状态。luaL_openlibs(L) 加载标准库。

// C code
#include <lua.h>
#include <lualib.h>
#include <lauxlib.h>

lua_State *L = luaL_newstate();
luaL_openlibs(L);
// ... use L ...
lua_close(L);

栈索引

正索引从栈底开始计数（1 = 栈底）。负索引从栈顶开始计数（-1 = 栈顶，-2 = 从栈顶起第二个）。

压入值

使用针对不同类型的压入函数，将各种类型的值压入栈中。

// C code
lua_pushnumber(L, 42.0);      // push number
lua_pushstring(L, "hello");   // push string
lua_pushboolean(L, 1);        // push true
lua_pushnil(L);               // push nil

读取值

使用 lua_to* 函数从栈中读取值，而不将其移除。

// C code
double n = lua_tonumber(L, -1);     // read top as number
const char *s = lua_tostring(L, 1); // read bottom as string
int b = lua_toboolean(L, -2);

操作栈

使用 lua_pop(L, n) 丢弃栈顶的 n 个值。lua_gettop(L) 返回当前栈高度。

// C code
lua_pushstring(L, "a");
lua_pushstring(L, "b");
printf("stack size: %d\n", lua_gettop(L)); // 2
lua_pop(L, 1);
printf("stack size: %d\n", lua_gettop(L)); // 1

类型检查

使用 lua_type(L, idx) 检查栈值的类型；它会返回 LUA_TNUMBER、LUA_TSTRING 等结果。

压入表

从 C 创建并填充一个新表。

// C code
lua_newtable(L);             // push empty table
lua_pushstring(L, "world");
lua_setfield(L, -2, "hello"); // t.hello = "world"

错误检查

大多数可能失败的 C API 函数都会返回错误代码（LUA_OK = 0）。请始终检查返回代码，并调用 lua_tostring(L, -1) 获取错误消息。

保持栈平衡

您有责任保持栈平衡。每次压入都必须对应一次弹出（或由调用消耗该值）。栈溢出会导致紧急处理。

栈模型问题

在 Lua C API 栈中，索引 -1 指向什么？

回顾：Lua C API 栈模型

Lua C API 使用虚拟栈进行所有数据交换。调用前压入值，调用后读取结果。可以使用正索引（从栈底向上）或负索引（从栈顶向下）。请保持栈平衡，以避免溢出。

常见问题解答

「Lua C API 的栈模型」课时是免费的吗？

是的 — 「Lua C API 的栈模型」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Lua Academy 课程的其余内容，请升级到 CoddyKit PRO。 Lua Academy 课程共包含 4 节课。

「Lua C API 的栈模型」这节课中我会学到什么？

理解 Lua 栈、索引以及基本的入栈和出栈操作。你通过在浏览器中直接运行的动手代码来练习 Lua Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Lua Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Lua Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「Lua C API 的栈模型」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Lua Academy 课中编写并运行代码吗？

能。每节 Lua Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Lua Academy