Lua 與 C 互操作深度實踐：擴展模組、腳本系統整合、除錯器實現

一、編寫 Lua C 擴展模組 (動態庫)

Lua 核心極小，標準庫 (io、string、math、table) 均以 C 模組形式實現並編譯進 lua.dll。自訂模組流程：

1. 定義 luaL_Reg 陣列映射 Lua 函數名 → C 函數
2. 實作 C 函數 (簽名 int func(lua_State *L))
3. 實作 luaopen_xxx 註冊模組
4. 編譯為動態庫 (.so/.dll) 放入 package.cpath 路徑

最小範例：mymathlib 提供 sin

#include "lua.h"
#include "lualib.h"
#include "lauxlib.h"
#include 

static int mysin(lua_State *L) {
    double d = luaL_checknumber(L, 1);  // 取第 1 參數，類型檢查
    lua_pushnumber(L, sin(d));          // 推回傳值
    return 1;                           // 回傳值個數
}

static const struct luaL_Reg mymathlib[] = {
    {"sin", mysin},
    {NULL, NULL}
};

__declspec(dllexport) int luaopen_mymathlib(lua_State *L) {
    luaL_register(L, "mymathlib", mymathlib);  // Lua 5.1 風格
    return 1;
}

Lua 測試：

require "mymathlib"
print(mymathlib.sin(0.5))

二、將 Lua 嵌入應用程式作為腳本系統

核心課題：C++ 物件 ↔ Lua userdata 綁定

手工綁定模式

1. 建立 userdata 存放 C++ 物件指標
2. 建立 metatable，設定 __index = metatable (方法查找回環)
3. 在 metatable 註冊 C 靜態函數作為方法
4. __gc 元方法處理 C++ 物件銷毀

自動化綁定工具對比

toLua++ 核心機制

• 多態：靜態函數後綴編號，執行時根據參數類型/個數線性搜尋匹配。
• 繼承：子類 metatable 的 __index 指向父類 metatable，形成查找鏈。
• 複雜成員：自動產生 getter/setter。

自製簡化綁定生成器 (GitHub 專案)

關鍵字標記：

{ module_begin = "LUACBIND_MODULE_BEGIN", module_end = "LUACBIND_MODULE_END",
  method_begin = "LUACBIND_METHOD_BEGIN", method_end = "LUACBIND_METHOD_END" }