UserData用法总结 lanyu出品

什么是UserData？

UserData 是一种数据结构，它可以用来存储任意类型的数据，并将其附加到 Lua 对象上。在 Lua 中，UserData 可以被视为一个外部对象，类似于指针，但在内部可以存储任何数据。

如何创建 UserData？

假设要给一个对象 obj 附加一个 UserData，并存储一个字符串 "Hello World"，代码如下：

local userdata = {}
userdata.message = "Hello World"
setmetatable(userdata, {__index = obj})
obj.userdata = userdata

这里创建了一个空的 table userdata，并把一个字符串 "Hello World" 存储在其中。然后使用 setmetatable 函数来把 userdata 与 obj 对象进行关联。

如何访问 UserData？

在代码中使用 obj.userdata 即可访问 userdata。

print(obj.userdata.message) -- 输出 "Hello World"

这里使用点号运算符来访问 userdata 中的属性。

为什么要使用UserData？

在 Lua 中，UserData 可以用来封装 C 语言代码。通过强大的 Lua/C API 机制，C 语言能够轻松地与 Lua 交互。
UserData 可以用来存储 Lua 中没有内置支持的类型，如 C 结构体。这个功能非常强大，可以通过 UserData 在 Lua 中实现一些高级功能。

示例1：使用 UserData 存储和访问自定义结构体

假设有一个自定义的 C 结构体定义如下：

typedef struct {
    int x;
    int y;
} Point;

使用其在 Lua 中使用 UserData 进行存储和访问的代码如下：

-- 创建 UserData
local pt = ffi.new("Point")
pt.x = 10
pt.y = 20
local userdata = {}
userdata.pt = pt
setmetatable(userdata, {__index = obj})
obj.userdata = userdata

-- 访问 UserData
print(obj.userdata.pt.x) -- 输出 "10"
print(obj.userdata.pt.y) -- 输出 "20"

这里使用 luajit 库中的 FFI 库来创建自定义结构体 Point。并在 Lua 中使用 UserData 把 Point 对象存储起来。最后使用点号运算符来访问 UserData 中的属性。

示例2：使用 UserData 封装 C 函数并在 Lua 中调用

假设有一个简单的 C 函数定义如下：

int add(int a, int b) {
    return a + b;
}

Lua 中使用 UserData 封装 C 函数并在 Lua 中调用的代码如下：

-- 封装 C 函数
local ffi = require("ffi")
ffi.cdef[[
    int add(int a, int b);
]]
local add_c = ffi.C.add

-- 创建 Lua 函数
local add_lua = function(a, b)
    return add_c(a, b)
end

-- 创建 UserData
local userdata = {}
userdata.add = add_lua
setmetatable(userdata, {__index = obj})
obj.userdata = userdata

-- 在 Lua 中调用 C 函数
print(obj.userdata.add(10, 20)) -- 输出 "30"

这里首先使用 ffi 库来创建了一个 C 函数 add，然后在 Lua 中创建了一个 Lua 函数 add_lua，用来调用 C 函数。接下来在 Lua 中使用 UserData 把 Lua 函数存储起来，最后在 Lua 中调用 C 函数。