Lua —— 轻量小巧脚本语言，支持与C相互调用

Lua 语言 logo

Lua 是巴西里约热内卢天主教大学（Pontifical Catholic University of Rio de Janeiro）里的一个研究小组于 1993 年开发。

Lua 用标准 C 语言编写并开放源代码。

优势：

• 轻量级：使用标准C语言编写，编译后仅仅100k+，可以很方便地加入嵌入式程序中。
• 可扩展：Lua 提供非常易于使用的扩展接口和机制。由宿主语言（通常是 C、C++）提供功能，Lua 如同内置功能一样进行调用。
• 支持面向过程编程和函数式编程
• 自动内存管理。只提供一种通用类型的表（table），可以用来实现数组，哈希表，集合，对象等。
• 提供多线程（协同进程）支持

但 Lua 目前没有提供强大的库，不适合作为开发独立应用程序的语言使用。

Lua 数据类型

测试数据类型（使用 type ）：

print(type("Hello world"))      --> string
print(type(10.4*3))             --> number
print(type(2))                  --> number
print(type(3.14))               --> number
print(type(print))              --> function
print(type(type))               --> function
print(type(true))               --> boolean
print(type(nil))                --> nil
print(type(type(nil)))          --> string

Lua 与 C 语言的交互

Lua 能与 C 语言交互是其最大的魅力之一。

运用 C 的库扩展了其强大的功能。

C 与 Lua 交互的部分称为 C API。C API 是一个 C 代码与 Lua 进行交互的函数集。主要组成部分为：

• 读写 Lua 全局变量的函数
• 调用 Lua 函数的函数
• 运行 Lua 代码片段的函数
• 注册 C 函数然后可以在 Lua 中被调用的函数

C 与 Lua 之间采用一个虚拟的栈进行通信，这样巧妙地解决了数据类型匹配问题和内存管理不一致的问题。

所有 C 与 Lua 之间的数据交换也都通过这个栈来完成。

Lua 以一个严格的 LIFO （后进先出）规则来操作栈。

1. C 调用 Lua

初始化和结束接口。

lua_State *L = lua_open();    // 创建 lua_State 堆栈（用于交换数据）。
luaL_openlibs(L);             // 初始化堆栈

...

lua_close(L);                 // 释放

C 与 Lua 的交互方式可以是通过 luaL_dostring （直接运行 Lua 代码）或 luaL_dofile （直接运行 Lua 文件）。

如 Lua 文件

// 文件名： test_lua.lua
print("This is Lua !")

可以执行：

// 可以直接执行代码
const char * buf = "print("This is Lua !")";
luaL_dostring(L, buf);

// 也可以直接执行文件
luaL_dofile(L, "test_lua.lua");

由于没有 include Lua 文件的机制。

如果需要访问 Lua 文件内的数据或接口，需要调用 luaL_loadfile 加载 Lua 文件，后续才能进行读取接口或数据。

下面以读取 test_lua.lua 文件为例：

int main()
{
    lua_State *L = lua_open();        // 创建 lua_State 堆栈（用于交换数据）。
    luaL_openlibs(L);                 // 初始化堆栈

    if(luaL_loadfile(L, filename))    // 返回 1 则加载出错
    {
        return -1;
    }
    
    ...

    lua_close(L);                     // 释放
    return 0;
}

调用 Lua 函数的方法

Lua 代码：

function add(a, b, c)
    local sum=a+b
    return sum,c
end

C 调用 Lua 函数：

lua_getglobal(L, "add");                      // 在Lua中，函数等同于变量，所以你可以这样来取得这个函数
lua_pushnumber(L, 100);                       // 将参数压栈，对应 a
lua_pushnumber(L, 20);                        // 将参数压栈，对应 b
lua_pushstring(L, "test add function");       // 将参数压栈，对应 c

lua_pcall(L, 3, 2, 0);                        // 调用函数，3个参数，2个返回值，错误处理函数（0表示没有，其它表示处理函数在栈的索引）。

const char * result1 = lua_tostring(L, -1);   // 返回值，对应返回的 c （按返回值入栈顺序，先是 sum, 后是 c, 所以 c 的顺序为 -1）
int result2 = lua_tonumber(L, -2);            // 返回值，对应返回的 sum

2. Lua 调用 C

C 函数：

int lua_strlen(lua_State *L)                    // Lua 用栈进行数据传递，所以参数用栈就可以了
{
    const char * ptr = lua_tostring(L, -1);     // 获取输入的第一个参数
    int len = strlen(ptr);                      // 计算字符串长度
    lua_pushnumber(L, len);                     // 计算结果入栈
    return 1;
}

int main()
{
    lua_State *L = lua_open();
    luaL_openlibs(L);

    ...

    lua_register(L, "lua_strlen", lua_strlen);  // 需要注册一下，声明暴露给 Lua 调用的接口和名称。

    ...

    lua_close(L);
    return 0;
}

Lua 调用文件：

function calc_length(s)
    local len=lua_strlen(s)
    return len
end

附录：C API 一些接口说明