0Pricing
Lua Academy · 课时

从 C 调用 Lua 函数

从 C 代码加载并执行 Lua 脚本和函数。

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

概述

要从 C 调用 Lua 函数，请依次压入函数、压入参数、调用 lua_pcall，然后从栈中读取结果。

加载 Lua 脚本

luaL_dofile(L, filename) 会加载并执行 Lua 文件。也可以使用 luaL_loadfile 加 lua_pcall，将加载与调用分开。

// C code
if (luaL_dofile(L, "config.lua") != LUA_OK) {
  fprintf(stderr, "Error: %s\n", lua_tostring(L, -1));
  lua_pop(L, 1);
}

获取全局函数

使用 lua_getglobal(L, "funcName") 将 Lua 全局函数压入栈中。

// C code
lua_getglobal(L, "myFunction"); // push function
lua_pushnumber(L, 10);          // push arg1
lua_pushnumber(L, 20);          // push arg2

lua_pcall

lua_pcall(L, nargs, nresults, errfunc) 调用栈中的函数。成功时返回 LUA_OK，并将结果留在栈中。

// C code
if (lua_pcall(L, 2, 1, 0) != LUA_OK) {
  fprintf(stderr, "Call error: %s\n", lua_tostring(L, -1));
  lua_pop(L, 1);
} else {
  double result = lua_tonumber(L, -1);
  lua_pop(L, 1);
  printf("Result: %f\n", result);
}

多个返回值

在 lua_pcall 中指定 nresults，即可读取多个返回值。它们会按顺序压入栈中。

// C: calling a Lua fn that returns two values
lua_getglobal(L, "minmax");
lua_pushnumber(L, 5); lua_pushnumber(L, 3);
lua_pcall(L, 2, 2, 0);
double mn = lua_tonumber(L, -2);
double mx = lua_tonumber(L, -1);
lua_pop(L, 2);

LUA_MULTRET

将 LUA_MULTRET 作为 nresults 传入，以接收函数的所有返回值。之后检查 lua_gettop(L)，即可知道返回了多少个值。

错误处理器

向 lua_pcall 传入非零的 errfunc，以使用自定义错误处理器。该处理器会接收错误对象，并可以添加回溯信息。

// C: setup traceback handler
lua_getglobal(L, "debug");
lua_getfield(L, -1, "traceback");
lua_remove(L, -2);  // remove debug table
int errhandler = lua_gettop(L);
// push fn and args, then:
lua_pcall(L, nargs, nresults, errhandler);

调用对象的方法

要调用 Lua 对象的方法，请依次压入方法、对象（self）和其他参数，然后执行调用。

将表作为参数传递

使用 lua_newtable 在栈上创建表，使用 lua_setfield 填充字段，然后将其作为函数参数传入。

引用注册表

使用 luaL_ref(L, LUA_REGISTRYINDEX) 将 Lua 值存储到注册表中，并获取一个整数键，以便稍后取回该值。

// C: store a callback for later use
lua_pushvalue(L, callbackIdx);
int ref = luaL_ref(L, LUA_REGISTRYINDEX);
// Later: lua_rawgeti(L, LUA_REGISTRYINDEX, ref);

清理

请始终弹出未使用的栈值。不平衡的栈会在多次调用中不断累积，最终导致溢出。在调试构建中检查栈大小。

lua_pcall 问题

lua_pcall(L, 2, 1, 0) 会执行什么操作？

回顾：从 C 调用 Lua

压入函数和参数，调用 lua_pcall，检查返回代码，然后从栈中读取结果。使用 luaL_ref 存储 Lua 回调，以便稍后使用。请始终弹出未使用的栈值。

常见问题解答

「从 C 调用 Lua 函数」课时是免费的吗？

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

「从 C 调用 Lua 函数」这节课中我会学到什么？

从 C 代码加载并执行 Lua 脚本和函数。 你通过在浏览器中直接运行的动手代码来练习 Lua Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Lua Academy 需要有经验吗？

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

「从 C 调用 Lua 函数」课时需要多长时间？

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

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

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

此课程中的所有课时

  1. Lua C API 的栈模型
  2. 从 C 调用 Lua 函数
  3. 在 Lua 中注册 C 函数
  4. 管理状态和错误处理
← 返回 Lua Academy