編寫 Lua C 擴展是提升性能、訪問系統底層接口的標準路徑。本文提供最小化完整示例:C 代碼實現 math.sin 封裝、Makefile 編譯 .so、Lua 腳本加載調用,涵蓋所有關鍵細節。
#include
#include
#include
#include "lua.h"
#include "lualib.h"
#include "lauxlib.h"
/* 庫打開函數前置聲明 */
int luaopen_mylib(lua_State *L);
/* 實現:lua 中調用 mylib.lsin(x) 返回 math.sin(x) */
static int l_sin(lua_State *L) {
double d = luaL_checknumber(L, 1); // 取第 1 參數,類型檢查
lua_pushnumber(L, sin(d)); // 壓入結果
return 1; // 返回值個數
}
/* 方法註冊表:{lua名, C函數}, 以 {NULL,NULL} 結尾 */
static const luaL_Reg mylib[] = {
{"lsin", l_sin},
{NULL, NULL}
};
/* 模塊打開函數:註冊庫表並返回 */
int luaopen_mylib(lua_State *L) {
luaL_register(L, "mylib", mylib); // Lua 5.1 風格
return 1;
}
/* 關鍵:若為 .cpp 文件,必須加 extern "C" 防止名字修飾
extern "C" int luaopen_mylib(lua_State *L); */
gcc mylibs.c -fPIC -shared -o libmylib.so -llua -lm
-fPIC:生成位置無關代碼(共享庫必須)。-shared:生成共享庫。-llua -lm:鏈接 Lua 庫和數學庫。CXX = gcc
LIBNAME = libmylib.so
SRC = mylibs.c
OBJ = $(SRC:.c=.o)
all: $(LIBNAME)
$(LIBNAME): $(OBJ)
$(CXX) -shared -o $@ $^ -llua -lm
%.o: %.c
$(CXX) -fPIC -c -Wall $< -o $@
clean:
rm -f *.o *.so
-- 加載動態庫並獲取模塊表
local mylib = package.loadlib("libmylib.so", "luaopen_mylib")()
-- 等價於: local mylib = require("mylib") (需將 .so 放在 package.cpath 路徑下)
print(mylib.lsin(10)) -- 輸出: -0.54402111088937
luaopen_mylib 對應 require "mylib",文件名通常為 libmylib.so 或 mylib.so。luaL_checknumber、luaL_checkstring、luaL_checkinteger 等,錯誤時自動拋出 Lua 錯誤。luaL_error(L, "msg") 拋出 Lua 異常。extern "C" 修飾打開函數,避免符號修飾導致 require 找不到符號。-g,用 gdb --args lua test.lua 調試 C 代碼。LD_DEBUG=libs lua test.lua 觀察動態庫加載過程。luaL_newlib 替代 luaL_register,返回表而非壓棧。掌握 Lua C 擴展開發流程,讓你在性能熱點、系統接口、現有 C 庫復用等場景游刃有餘。