lua动态链接库（luaopen_*函数的使用）

lua中使用c动态库，像luacjson（支持unicode），luasocket,都是以动态链接库的形式在lua中使用的，至于怎么写这些动态链接库很少有教程说到，下面我就说说如何把c文件编译成动态库。

首先，假设需要在lua中调用一个在c中实现的求和函数，函数名add(a,b)。

我给这个测试库取名为dylib，它包含一个函数add。lua中这样使用：

    local dylib = require "dylib.test"
    local c = dylib.add(1,2)
    print(c)

上面的dylib.test就是我编译生成的dylib/test.so文件。这个文件该怎么生成？如下：

    int
    luaopen_dylib_test(lua_State* L) {
        luaL_Reg l[] = {
           { "add", *dylib_add* },
           { NULL, NULL },
        };
        luaL_checkversion(L);
        luaL_newlib(L,l);

        return 1;
    }

这个函数名有个命名规则，前缀为luaopen，后面就是lua中require的字符串（将'.'转换成''）。当执行到require "dylib.test"时，lua解析器会去dylib/test.so文件中寻找并执行函数名为luaopen_dylib_test的函数。找不到则报错：

    lua: error loading module 'dylib.test' from file './dylib/test.so':
        ./dylib/test.so: undefined symbol: luaopen_dylib_test
    stack traceback:
        [C]: in ?
        [C]: in function 'require'
        test.lua:1: in main chunk
        [C]: in ?

注意到dylib_add就是就是要实现的dylib.add函数。现在实现它：

    int
    dylib_add(lua_State* L) {
        int a = lua_tonumber(L,1);
        int b = lua_tonumber(L,2);
        int c = a+b;
        lua_pop(L,2);
        lua_pushnumber(L,c);
        return 1;
    }

这函数就是把两参数加起来，然后返回和。最后编译生成so文件：

    gcc -g -Wall --shared -fPIC -o dylib/test.so dylib_test.c

注意要给它建一个文件夹dylib。因为require的时候会把"dylib.test"转成"dylib/test"默认去该路径下寻找so或者lua文件。当然，你修改了搜索路径那是另外一回事了。

基本的就是这样子了。正在看云风的hive游戏服务器框架（skynet的精简版，不是apache hive）。

下一篇会讲到luaL_requiref函数，实现一个动态库so文件中包含多个库。因为直接用两个luaopen函数是有问题的，一般一个luaopen函数对应一个so文件。

hanxi / blog

lua动态链接库（luaopen_*函数的使用） #60