tolua++ 實戰：將 C/C++ 庫綁定到 Lua 腳本

什麼是 tolua++

tolua++ 為 Lua 提供面向物件綁定支援，自動生成 C/C++ 到 Lua 的胶水代碼，讓 Lua 腳本能直接調用 C++ 類別、函數與變量。

環境構建（免 SCons）

僅需 Lua 開發包：

# 編譯靜態庫
cd tolua++_1.0.5-1/src/lib
gcc -c *.c -I../../include -I <lua_path>/include
ar rcsv libtolua++.a *.o

部署到 Cygwin/MinGW：

• 可執行檔 → bin/
• 頭文件 → usr/include/
• 靜態庫 → lib/

完整工作流程

1. 編寫 .pkg 宣告文件：列出需暴露給 Lua 的類、函數、常量。
2. 生成綁定代碼：tolua++ -o test.c tarray.pkg（產生千行級 C 代碼）。
3. 編譯業務代碼與綁定代碼：

   gcc tarray.c -c
   gcc test.c tarray.h -c

4. 鏈接生成可執行檔：

   gcc -o tarray.exe tarray.o test.o -llua -llualib -ltolua++

5. 編寫 Lua 腳本（tarray.lua）並執行。

關鍵 C 端啟動代碼

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

extern int tolua_tarray_open(lua_State*);

int main() {
    lua_State* L = lua_open();
    luaopen_base(L);
    tolua_tarray_open(L);  // 註冊綁定
    lua_dofile(L, "tarray.lua");
    lua_close(L);
    return 0;
}

驗證範例輸出

1 2 3 ... 10
1 2 3 ... 9

對應 Lua 腳本遍歷 C 陣列 a[] 與結構體陣列 p[].x。

總結

tolua++ 透過 .pkg → .c → 編譯鏈接 → Lua 腳本 流程，實現零手寫胶水代碼的 C/C++ 到 Lua 綁定，適合遊戲邏輯、UI 配置等熱更新場景。