Xlua分析：C#调用Lua

2024-02-04 06:20
文章标签 c# 分析 调用 lua .net netcore xlua

本文主要是介绍Xlua分析：C#调用Lua，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

本篇主题是C#如何调用lua的补充。

xLua交互知识

参考官方文档《programming in lua》的第24章开头，里面很详细地阐述了Lua和C++是如何实现交互的：栈操作。Lua API用一个抽象的栈在Lua与C之间交换值。栈中的每一条记录都可以保存任何 Lua 值。如果想要从Lua请求一个值（比如一个全局变量的值）则调用Lua，被请求的值将会被压入栈；如果想要传递一个值给 Lua，首先将这个值压入栈，然后调用 Lua（这个值就会被弹 出）。几乎所有的 API函数都用到了栈。而C#显而易见也可以和C++一侧进行交互，由此即可得出lua和C#可以通过C/C++这一层来进行通信，主要方法即是lua的堆栈操作。

C#获取Lua入口

首先写一段测试代码：

[LuaCallCSharp]
public class LuaTableTest
{public LuaTable tab = null;public Action<LuaTable> luaFunc = null;
}

然后经过Xlua Generate Code后可以观察Set方法，得到流程的起点：translator.GetObject

[MonoPInvokeCallbackAttribute(typeof(LuaCSFunction))]
static int _s_set_tab(RealStatePtr L)
{try {ObjectTranslator translator = ObjectTranslatorPool.Instance.Find(L);XluaTool.LuaTableTest gen_to_be_invoked = (XluaTool.LuaTableTest)translator.FastGetCSObj(L, 1);gen_to_be_invoked.tab = (XLua.LuaTable)translator.GetObject(L, 2, typeof(XLua.LuaTable));} catch(System.Exception gen_e) {return LuaAPI.luaL_error(L, "c# exception:" + gen_e);}return 0;
}[MonoPInvokeCallbackAttribute(typeof(LuaCSFunction))]
static int _s_set_luaFunc(RealStatePtr L)
{try {ObjectTranslator translator = ObjectTranslatorPool.Instance.Find(L);XluaTool.LuaTableTest gen_to_be_invoked = (XluaTool.LuaTableTest)translator.FastGetCSObj(L, 1);gen_to_be_invoked.luaFunc = translator.GetDelegate<System.Action<XLua.LuaTable>>(L, 2);} catch(System.Exception gen_e) {return LuaAPI.luaL_error(L, "c# exception:" + gen_e);}return 0;
}

可以看到，translator.GetObject负责把相应Lua类型转换成C#类型数据并返回。而GetObject内部是由GetCaster函数实现转换的：

public ObjectCast GetCaster(Type type)
{if (type.IsByRef) type = type.GetElementType();Type underlyingType = Nullable.GetUnderlyingType(type);if (underlyingType != null){return genNullableCaster(GetCaster(underlyingType)); }ObjectCast oc;if (!castersMap.TryGetValue(type, out oc)){oc = genCaster(type);castersMap.Add(type, oc);}return oc;
}

castersMap内部已经定义了各个类型的转换函数：

public ObjectCasters(ObjectTranslator translator)
{this.translator = translator;castersMap[typeof(char)] = charCaster;castersMap[typeof(sbyte)] = sbyteCaster;castersMap[typeof(byte)] = byteCaster;castersMap[typeof(short)] = shortCaster;castersMap[typeof(ushort)] = ushortCaster;castersMap[typeof(int)] = intCaster;castersMap[typeof(uint)] = uintCaster;castersMap[typeof(long)] = longCaster;castersMap[typeof(ulong)] = ulongCaster;castersMap[typeof(double)] = getDouble;castersMap[typeof(float)] = floatCaster;castersMap[typeof(decimal)] = decimalCaster;castersMap[typeof(bool)] = getBoolean;castersMap[typeof(string)] =  getString;castersMap[typeof(object)] = getObject;castersMap[typeof(byte[])] = getBytes;castersMap[typeof(IntPtr)] = getIntptr;//special typecastersMap[typeof(LuaTable)] = getLuaTable;castersMap[typeof(LuaFunction)] = getLuaFunction;
}

所以接下来的任务无非就是研究getLuaTable和getLuaFunction如何实现的了。

C#获取Lua table

getLuaFunction实现如下：

private object getLuaTable(RealStatePtr L, int idx, object target)
{if (LuaAPI.lua_type(L, idx) == LuaTypes.LUA_TUSERDATA){object obj = translator.SafeGetCSObj(L, idx);return (obj != null && obj is LuaTable) ? obj : null;}if (!LuaAPI.lua_istable(L, idx)){return null;}LuaAPI.lua_pushvalue(L, idx);return new LuaTable(LuaAPI.luaL_ref(L), translator.luaEnv);
}

主要步骤即是通过luaL_ref添加到Lua注册表中并获取索引位置，创建一个C#侧的LuaTable对象用于管理。之后获取这个table即可直接用这个LuaTable对象即可。

如果使用测试代码

LuaTableTest.tab.Get<int>("testVal")

来获取相应变量信息，实际上内部执行的是table.Get接口：

public void Get<TKey, TValue>(TKey key, out TValue value)
{
#if THREAD_SAFE || HOTFIX_ENABLElock (luaEnv.luaEnvLock){
#endifvar L = luaEnv.L;var translator = luaEnv.translator;int oldTop = LuaAPI.lua_gettop(L);LuaAPI.lua_getref(L, luaReference);translator.PushByType(L, key);if (0 != LuaAPI.xlua_pgettable(L, -2)){string err = LuaAPI.lua_tostring(L, -1);LuaAPI.lua_settop(L, oldTop);throw new Exception("get field [" + key + "] error:" + err);}LuaTypes lua_type = LuaAPI.lua_type(L, -1);Type type_of_value = typeof(TValue);if (lua_type == LuaTypes.LUA_TNIL && type_of_value.IsValueType()){throw new InvalidCastException("can not assign nil to " + type_of_value.GetFriendlyName());}try{translator.Get(L, -1, out value);}catch (Exception e){throw e;}finally{LuaAPI.lua_settop(L, oldTop);}
#if THREAD_SAFE || HOTFIX_ENABLE}
#endif
}

可以看到，我们首先通过getref（之前new luaTable的时候已经做了添加ref的操作了）拿到table的reference，然后再通过这个reference查询到key的位置并取出，即可得到相应的数据了。

根据LuaTable获取变量

 在Get代码中有一处细节：translator.Get，内部有提前封装好的基本类型对象转换，比如int、double、string类型等，这些都可以直接通过Lua API实现转换，LuaAPI.xlua_tointeger这些也仅仅是对原生API的简单封装。

public void Get<T>(RealStatePtr L, int index, out T v)
{Func<RealStatePtr, int, T> get_func;if (tryGetGetFuncByType(typeof(T), out get_func)){v = get_func(L, index);}else{v = (T)GetObject(L, index, typeof(T));}
}
bool tryGetGetFuncByType<T>(Type type, out T func) where T : class
{if (get_func_with_type == null){get_func_with_type = new Dictionary<Type, Delegate>(){{typeof(int), new Func<RealStatePtr, int, int>(LuaAPI.xlua_tointeger) },{typeof(double), new Func<RealStatePtr, int, double>(LuaAPI.lua_tonumber) },{typeof(string), new Func<RealStatePtr, int, string>(LuaAPI.lua_tostring) },{typeof(byte[]), new Func<RealStatePtr, int, byte[]>(LuaAPI.lua_tobytes) },{typeof(bool), new Func<RealStatePtr, int, bool>(LuaAPI.lua_toboolean) },{typeof(long), new Func<RealStatePtr, int, long>(LuaAPI.lua_toint64) },{typeof(ulong), new Func<RealStatePtr, int, ulong>(LuaAPI.lua_touint64) },{typeof(IntPtr), new Func<RealStatePtr, int, IntPtr>(LuaAPI.lua_touserdata) },{typeof(decimal), new Func<RealStatePtr, int, decimal>((L, idx) => {decimal ret;Get(L, idx, out ret);return ret;}) },{typeof(byte), new Func<RealStatePtr, int, byte>((L, idx) => (byte)LuaAPI.xlua_tointeger(L, idx) ) },{typeof(sbyte), new Func<RealStatePtr, int, sbyte>((L, idx) => (sbyte)LuaAPI.xlua_tointeger(L, idx) ) },{typeof(char), new Func<RealStatePtr, int, char>((L, idx) => (char)LuaAPI.xlua_tointeger(L, idx) ) },{typeof(short), new Func<RealStatePtr, int, short>((L, idx) => (short)LuaAPI.xlua_tointeger(L, idx) ) },{typeof(ushort), new Func<RealStatePtr, int, ushort>((L, idx) => (ushort)LuaAPI.xlua_tointeger(L, idx) ) },{typeof(uint), new Func<RealStatePtr, int, uint>(LuaAPI.xlua_touint) },{typeof(float), new Func<RealStatePtr, int, float>((L, idx) => (float)LuaAPI.lua_tonumber(L, idx) ) },};}Delegate obj;if (get_func_with_type.TryGetValue(type, out obj)){func = obj as T;return true;}else{func = null;return false;}
}

C#获取Function

以上已经说明，如果只是为了获取某个table内部的相关变量，其实走Get就已经满足需求，但是有些函数依然还需要调用，比如一些匿名函数：

XluaTool.LuaTableTest.luaFunc= function()
end

此时需要转换成delegate形式供C#侧调用，如第二段代码块中所示：

gen_to_be_invoked.luaFunc = translator.GetDelegate<System.Action<XLua.LuaTable>>(L, 2);

而跳转GetDelegate直到CreateDelegateBridge函数，会发现其中有一些代码和GetLuaTable非常相似，即会存储在lua注册表中，然后给出一个索引，最后通过DelegateBridgeBase类进行存储：

public object CreateDelegateBridge(RealStatePtr L, Type delegateType, int idx)
{......LuaAPI.lua_pushvalue(L, idx);int reference = LuaAPI.luaL_ref(L);LuaAPI.lua_pushvalue(L, idx);LuaAPI.lua_pushnumber(L, reference);LuaAPI.lua_rawset(L, LuaIndexes.LUA_REGISTRYINDEX);DelegateBridgeBase bridge;try{
#if (UNITY_EDITOR || XLUA_GENERAL) && !NET_STANDARD_2_0if (!DelegateBridge.Gen_Flag){bridge = Activator.CreateInstance(delegate_birdge_type, new object[] { reference, luaEnv }) as DelegateBridgeBase;}else
#endif{bridge = new DelegateBridge(reference, luaEnv);}}......
}

LuaBase Dispose

C#这边释放lua侧资源时需要调用相关接口，以防Lua侧一直认为C#侧持有lua相关资源。可以着重观察Xlua给的LuaBase析构函数的处理方式：

public void Dispose()
{Dispose(true);GC.SuppressFinalize(this);
}public virtual void Dispose(bool disposeManagedResources)
{if (!disposed){if (luaReference != 0){
#if THREAD_SAFE || HOTFIX_ENABLElock (luaEnv.luaEnvLock){
#endifbool is_delegate = this is DelegateBridgeBase;if (disposeManagedResources){luaEnv.translator.ReleaseLuaBase(luaEnv.L, luaReference, is_delegate);}else //will dispse by LuaEnv.GC{luaEnv.equeueGCAction(new LuaEnv.GCAction { Reference = luaReference, IsDelegate = is_delegate });}
#if THREAD_SAFE || HOTFIX_ENABLE}
#endif}disposed = true;}
}

调用Dispose接口，里面通知了translator此luaBase需要被释放，而translator则开始对lua注册表进行pop工作，尤其不要忘记之前的reference存储工作，也是要进行解绑的，如最后一句LuaAPI.lua_unref操作：

public void ReleaseLuaBase(RealStatePtr L, int reference, bool is_delegate)
{if(is_delegate){LuaAPI.xlua_rawgeti(L, LuaIndexes.LUA_REGISTRYINDEX, reference);if (LuaAPI.lua_isnil(L, -1)){LuaAPI.lua_pop(L, 1);}else{LuaAPI.lua_pushvalue(L, -1);LuaAPI.lua_rawget(L, LuaIndexes.LUA_REGISTRYINDEX);if (LuaAPI.lua_type(L, -1) == LuaTypes.LUA_TNUMBER && LuaAPI.xlua_tointeger(L, -1) == reference) //{//UnityEngine.Debug.LogWarning("release delegate ref = " + luaReference);LuaAPI.lua_pop(L, 1);// pop LUA_REGISTRYINDEX[func]LuaAPI.lua_pushnil(L);LuaAPI.lua_rawset(L, LuaIndexes.LUA_REGISTRYINDEX); // LUA_REGISTRYINDEX[func] = nil}else //another Delegate ref the function before the GC tick{LuaAPI.lua_pop(L, 2); // pop LUA_REGISTRYINDEX[func] & func}}LuaAPI.lua_unref(L, reference);delegate_bridges.Remove(reference);}else{LuaAPI.lua_unref(L, reference);}
}

这篇关于Xlua分析：C#调用Lua的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/676576。

相关文章

性能分析之MySQL索引实战案例

性能分析之MySQL索引实战案例

文章目录 一、前言二、准备三、MySQL索引优化四、MySQL 索引知识回顾五、总结 一、前言 在上一讲性能工具之 JProfiler 简单登录案例分析实战中已经发现SQL没有建立索引问题，本文将一起从代码层去分析为什么没有建立索引？ 开源ERP项目地址：https://gitee.com/jishenghua/JSH_ERP 二、准备 打开IDEA找到登录请求资源路径位置
阅读更多...
2. c#从不同cs的文件调用函数

2. c#从不同cs的文件调用函数

1.文件目录如下： 2. Program.cs文件的主函数如下 using System;using System.Collections.Generic;using System.Linq;using System.Threading.Tasks;using System.Windows.Forms;namespace datasAnalysis{internal static
阅读更多...
如何在页面调用utility bar并传递参数至lwc组件

如何在页面调用utility bar并传递参数至lwc组件

1.在app的utility item中添加lwc组件： 2.调用utility bar api的方式有两种： 方法一，通过lwc调用： import {LightningElement,api ,wire } from 'lwc';import { publish, MessageContext } from 'lightning/messageService';import Ca
阅读更多...
C#实战|大乐透选号器[6]：实现实时显示已选择的红蓝球数量

C#实战|大乐透选号器[6]：实现实时显示已选择的红蓝球数量

哈喽，你好啊，我是雷工。 关于大乐透选号器在前面已经记录了5篇笔记，这是第6篇； 接下来实现实时显示当前选中红球数量，蓝球数量； 以下为练习笔记。 01 效果演示 当选择和取消选择红球或蓝球时，在对应的位置显示实时已选择的红球、蓝球的数量； 02 标签名称 分别设置Label标签名称为：lblRedCount、lblBlueCount
阅读更多...
用命令行的方式启动.netcore webapi

用命令行的方式启动.netcore webapi

用命令行的方式启动.netcore web项目 进入指定的项目文件夹，比如我发布后的代码放在下面文件夹中 在此地址栏中输入“cmd”，打开命令提示符，进入到发布代码目录 命令行启动.netcore项目的命令为:  dotnet 项目启动文件.dll --urls="http://*:对外端口" --ip="本机ip" --port=项目内部端口 例： dotnet Imagine.M
阅读更多...
SWAP作物生长模型安装教程、数据制备、敏感性分析、气候变化影响、R模型敏感性分析与贝叶斯优化、Fortran源代码分析、气候数据降尺度与变化影响分析

SWAP作物生长模型安装教程、数据制备、敏感性分析、气候变化影响、R模型敏感性分析与贝叶斯优化、Fortran源代码分析、气候数据降尺度与变化影响分析

查看原文>>>全流程SWAP农业模型数据制备、敏感性分析及气候变化影响实践技术应用 SWAP模型是由荷兰瓦赫宁根大学开发的先进农作物模型，它综合考虑了土壤-水分-大气以及植被间的相互作用；是一种描述作物生长过程的一种机理性作物生长模型。它不但运用Richard方程，使其能够精确的模拟土壤中水分的运动，而且耦合了WOFOST作物模型使作物的生长描述更为科学。 本文让更多的科研人员和农业工作者
阅读更多...
MOLE 2.5 分析分子通道和孔隙

MOLE 2.5 分析分子通道和孔隙

软件介绍 生物大分子通道和孔隙在生物学中发挥着重要作用，例如在分子识别和酶底物特异性方面。 我们介绍了一种名为 MOLE 2.5 的高级软件工具，该工具旨在分析分子通道和孔隙。 与其他可用软件工具的基准测试表明，MOLE 2.5 相比更快、更强大、功能更丰富。作为一项新功能，MOLE 2.5 可以估算已识别通道的物理化学性质。 软件下载 https://pan.quark.cn/s/57
阅读更多...
衡石分析平台使用手册-单机安装及启动

衡石分析平台使用手册-单机安装及启动

单机安装及启动​ 本文讲述如何在单机环境下进行 HENGSHI SENSE 安装的操作过程。 在安装前请确认网络环境，如果是隔离环境，无法连接互联网时，请先按照 离线环境安装依赖的指导进行依赖包的安装，然后按照本文的指导继续操作。如果网络环境可以连接互联网，请直接按照本文的指导进行安装。 准备工作​ 请参考安装环境文档准备安装环境。 配置用户与安装目录。 在操作前请检查您是否有 sud
阅读更多...
线性因子模型 - 独立分量分析（ICA）篇

线性因子模型 - 独立分量分析（ICA）篇

序言 线性因子模型是数据分析与机器学习中的一类重要模型，它们通过引入潜变量（ latent variables \text{latent variables} latent variables）来更好地表征数据。其中，独立分量分析（ ICA \text{ICA} ICA）作为线性因子模型的一种，以其独特的视角和广泛的应用领域而备受关注。 ICA \text{ICA} ICA旨在将观察到的复杂信号
阅读更多...
【软考】希尔排序算法分析

【软考】希尔排序算法分析

目录 1. c代码2. 运行截图3. 运行解析 1. c代码 #include <stdio.h>#include <stdlib.h> void shellSort(int data[], int n){// 划分的数组，例如8个数则为[4, 2, 1]int *delta;int k;// i控制delta的轮次int i;// 临时变量，换值int temp;in
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2