跳到主要内容

zlua 标准库

全局 zlua 在 lua_State 初始化时加载（zlualib.lua）。类型访问走 CSharp；类型构造、重载、ref、数组、delegate 转换走 zlua。

源码：ZLua~/lualib/zlualib.lua

类型与签名​

zlua.typeof(typeTable) → System.Type​

返回该类型的 System.Type 反射对象（Lua 侧为 System.Type class userdata），语义对应 C# 的 typeof(T)。

参数 / 返回说明
typeTable任意 ZLua 类型表（CSharp 基础表、闭合泛型表、数组类型表等）
返回值System.Type 实例，如 zlua.typeof(CSharp['mscorlib']['System.Int32']) ≡ C# typeof(int)
local intType = zlua.typeof(CSharp['mscorlib']['System.Int32'])  -- ≡ typeof(int)
local t = zlua.typeof(CSharp.AC.Demo)                            -- ≡ typeof(Demo)
local ListInt = zlua.make_generic_type(
    CSharp.mscorlib['System.Collections.Generic.List`1'],
    zlua.types.int32
)
local listType = zlua.typeof(ListInt)                            -- ≡ typeof(List<int>)

zlua.get_type_from_name(typeFullName) → typeTable​

对标 System.Type.GetType(string name)：按名称解析并返回类型表。支持 Assembly-qualified name、泛型、数组等。

local Int32 = zlua.get_type_from_name("System.Int32")
local IntArr = zlua.get_type_from_name("System.Int32[]")

zlua.types.*​

内置 corlib 类型名字符串，见 zlua.types 完整表。

zlua.signature(typeArg, ...) → signature​

构造 参数类型 括号串（如 "(System.Int32)"），供对照 / 拼接全签名键。不包含方法名。

参数说明
typeArg...zlua.types.*、zlua.typeof(T) 或类型表
local sig = zlua.signature(zlua.types.int32, zlua.types.string)
-- "(System.Int32,System.String)"
-- 全签名键 = 方法名 .. sig → "Run(System.Int32,System.String)"

同名多候选时 Bind 已自动注册全签名键，一般直接：

demo['Run(System.Int32)'](demo, 10)

禁止把仅参数括号（无方法名）当作元表键。

zlua.register_method(aliasName, closure) → void​

把 direct closure 挂到尚未占用的短名；注册后可用冒号调用。

参数说明
aliasName新 method 键；不得与已有默认名 / 全签名键 / 别名冲突
closuredirect method closure（如 demo['Run(System.Int32)']）
local run_i32 = demo['Run(System.Int32)']
zlua.register_method("run_i32", run_i32)
demo:run_i32(20)   -- 短名 + 冒号；这才是 register 的收益

两参数形式；目标表由 closure 绑定域推断。详见 重载规范 §6.1。

泛型​

zlua.make_generic_type(genericBaseType, typeArg...) → typeTable​

闭合开放泛型定义，如 List<int>。

local ListInt = zlua.make_generic_type(
    CSharp.mscorlib['System.Collections.Generic.List`1'],
    zlua.types.int32)
local list = ListInt()

zlua.make_generic_inst(typeArg...) → genericInst​

泛型 方法 的类型实参包（非类型表）。

Opaque / ref​

ref / out / in 无 单独的 zlua.new_ref（已移除）。Lua→C# 写回依赖实参形态：同型 ByValUserData（如 Point2D(...)）或兼容 Opaque；裸 number/string 只进临时槽。见 ref/out/in 指南、03-BYREF。

zlua.to_user_data(opaque) → userdata​

将 C#→Lua 推送的 OpaqueValue（lightuserdata）升级为 StructUserData / ClassUserData。须在 同步调用链 内使用。

另：get_opaquevalue / set_opaquevalue 见同规范 Opaque 节。

数组​

API参数返回值说明
make_szarray_type(elementType)元素类型数组类型表T[]
make_mdarray_type(elementType, rank)元素类型、秩多维类型表T[,] 等
new_szarray_by_element_type(type, len)元素类型、长度ArrayUserData
new_szarray_by_szarray_type(arrType, len)数组类型表、长度ArrayUserData
new_mdarray_by_mdarray_type(mdType, low, sizes)类型、下界、尺寸ArrayUserData
new_mdarray_by_spec(elementType, low, sizes)元素类型、下界、尺寸ArrayUserData便捷构造
to_table(szarray)一维数组Lua table1-based 索引
to_bytes(szarray)元素为 blittable（基元或无引用字段的 struct）的 szarraystring按数组内存字节拷贝

Delegate​

zlua.to_delegate(func, delegateType) → delegateUserdata​

将 Lua function 转为指定 Delegate 类型 userdata（显式形态；方法形参通常可直传 function）。

local handler = zlua.to_delegate(function(x) print(x) end, CSharp.AC['System.Action`1'])

Mono / Il2Cpp 实现状态​

双端 Lua 可见语义一致；下表均为已实现。

APIMonoIl2Cpp
typeof / types / signature✅✅
register_method✅✅
make_generic_type / make_generic_inst✅✅
get/set_opaquevalue / to_user_data✅✅
make_szarray_* / new_szarray_*✅✅
make_mdarray_*✅✅
to_table / to_bytes✅✅
to_delegate✅✅

完整语义：zlua 库规范

相关文档​