Lua 脚本 C++ 封装库 LuaWrapper

为什么要用Lua作脚本?
使用Lua作脚本,主要是因为它小巧玲珑(体积小,运行快),而且它的语法又比较简单明了。不过,使用LuaAPI将Lua引擎集成到程序中,确实有一些不方便——用落木随风网友的话来说,就是"就象用汇编"。当然,现在你不用再这么辛苦了,因为你可以使用LuaWrapper For C++。使用这个工具,在C++中集成Lua脚本就是轻而易举的事。你原有的C++函数和类,几乎不需要任何改变,就可以与Lua脚本共享。
我们接下来,用实例来说明,如何用LuaWrapper来集成Lua脚本到你的程序中去。

1.  创建Lua引擎
LuaWrap lua; 或者 LuaWrap* lua = new LuaWrap;
创建一个LuaWrap对象,就是创建一个Lua脚本引擎。并且根据Lua的特性,你可以创建任意多个Lua引擎,甚至可以分布在不同的线程当中。

2.  装载并执行脚本程序
你可以从缓冲区中装载Lua脚本:
lua.LoadString(
"print('Hello World')"
);
当然,你也可以从文件中装入,并执行Lua脚本:
Lua.LoadFile("./test.lua");
Lua的脚本,可以是源代码,也可以经过编译后的中间代码。也许你对编译后的中间代码更感兴趣——如果你不希望让源代码赤裸裸的袒露在大家的眼前。

3.  获取和设置Lua变量
能够获取和设置脚本变量的内容,是一个最基本的功能。你可以使用GetGlobal和SetGlobal函数来做到这一点:
(1)  获取变量:
int a = lua.GetGlobal<int>("a");
LuaTable table = lua.GetGlobal<LuaTable>("t");
这里,<> 里头的类型,就是想要的变量的类型。
(2)  设置变量:
lua.SetGlobal("a", a); 
lua.SetGlobal("t", table);

4.  调用Lua函数
使用Call函数,就可以很简单的从你的程序中调用Lua函数:
lua.Call<void>("print", "Hello World");
int sum = lua.Call<int>("add", 2, 3);
这里,<> 里头的类型是返回值的类型。

5.  如何让Lua也能调用C++的函数
精采的地方来了。假如有下面这样的一个函数:
int add(int a, int b)
{
return a + b;
}
如果想让它能够让Lua使用,只需将它注册到Lua引擎当中就可以了:
lua.RegisterFunc("add", int(int,int), add);
这样,Lua中就可以用直接使用了:
(Lua脚本)sum = add(1, 3) 

(*) RegisterFunc的功能,就是让你把C++的函数注册到Lua中,供Lua脚本使用。
第一个参数,是想要在Lua中用的函数名。
第二个参数,是C++中函数的原型; C++允许函数重载的,你可以使用函数原型,来选择需要注册到Lua引擎中的那个函数。
第三个参数,就是C++中函数的指针了。

6.  如何能让C++的类在Lua中使用
我们先看看下面这个C++类:
class MyArray
{
  std::vector<double> array;
public:
  void setvalue(int index, double value);
  double getvalue(int index);
  int size();
  const char* ToString();
};

你准备要让Lua能够自由访问并操作这个类。很简单,你只需增加几个宏定义就可以了:

class MyArray
{
  std::vector<double> array;
public:
  void setvalue(int index, double value);
  double getvalue(int index);
  int size();
  const char* ToString();
  // 将一个 class 作为一个 Lua 对象是很容易的,只需要增加以下宏定义。
  DEFINE_TYPENAME("My.array");
  BEGIN_REGLUALIB("array")
      LUALIB_ITEM_CREATE("new", MyArray )  // 创建MyArray 
      LUALIB_ITEM_DESTROY("del", MyArray )  // 消除MyArray。
  END_REGLUALIB()
  BEGIN_REGLUALIB_MEMBER()
    LUALIB_ITEM_FUNC("size", int (MyArray*), &MyArray::size)
    LUALIB_ITEM_FUNC("__getindex", double(MyArray*, int), &MyArray::getvalue)  
    LUALIB_ITEM_FUNC("__newindex", void (MyArray*, int, double), &MyArray::setvalue)
    LUALIB_ITEM_FUNC("__tostring", const char* (MyArray*), &MyArray::ToString)
    LUALIB_ITEM_DESTROY("__gc", MyArray )   // 垃圾收集时消除对象用。
  END_REGLUALIB_MEMBER()
};

只要有了这些宏定义,这个类就是可以在Lua中使用的类了,我们就可以在Lua中注册这个类了:
lua.Register<MyArray>()

这样注册以后,我们在Lua中就可以使用这个类了:
a = array.new()  -- 创建对象,相当于 a = new Myarray
a[1] = 10  -- 调用__newindex,也就是C++中的 a->setvalue(1, 10)
a[2] = 20  -- 调用__newindex,也就是C++中的 a->setvalue(2, 20)
print(
a,  -- 调用 __tostring,也就是C++中的 a->ToString()
a:size(), -- 相当于C++中的 a->size()
a[1], -- 调用__getindex,也就是C++中的a->getvalue(1)
a[2]) --调用__getindex,也就是C++中的a->getvalue(2)
array.del(a)  -- 清除对象,相当于 delete a
a = nil  -- 清空 a,很象C++中的 a = NULL

当然,你也可以不用del这个对象,而是等待Lua帮你自动进行垃圾回收。在Lua进行垃圾回收时,它会自动调用这个对象的 __gc ,相当于 delete。

那么,在C++中要创建MyArray对象,并且传递给Lua全局变量怎么办?就象前面讲过的一样,使用SetGlobal:
MyArray* a = new MyArray; 
lua.SetGlobal("a", a);
要获取该对象,同样的,应该使用GetGlobal:
MyArray* a = lua.GetGlobal<MyArray>("a");

对于传递给Lua的对象,就让Lua来管理该对象的生存周期好了。如果你非要删除它的话,你可以使用DelGlobalObject:
lua.DelGlobalObject<MyArray>("a");
不过这么做的话,你应当明白你在做什么,因为在Lua的脚本中,可能已经在多处引用了这个对象了。删除了其中一个,将导致其它引用对象失效,从而可能引致系统崩溃。

(1)  DEFINE_TYPENAME("My.array");
定义类型的名称。在Lua中,这个类型名称是唯一用来识别C++类型的,你必须为不同的对象给予不同的名称。

(2)  BEGIN_REGLUALIB("array") ... END_REGLUALIB()
你可以为一个对象定义一个程序库,"array"就是程序库的名字。在程序库中定义的函数是全局函数,在Lua中,使用该函数,需要在函数前加上库的名字,如:array.new()。通常,程序库会包含创建对象的方法。如:
LUALIB_ITEM_CREATE("new", MyArray )  // 创建MyArray

    这样子,你才能在Lua中创建MyArray:
a = array.new()

你也可以选择增加一个删除对象操作:
LUALIB_ITEM_DESTROY("del", MyArray )   // 删除MyArray
这样,你就可以直接删除一个对象了:
array.del(a)

(3)  BEGIN_REGLUALIB_MEMBER() ...END_REGLUALIB_MEMBER()
在此处,你可以定义对象的成员函数,也可以重载对象的操作符——是的,就象C++的operator重载。例如:
LUALIB_ITEM_FUNC("__newindex", void (MyArray*, int, double), &MyArray::setvalue)
就是重载 operator[] 操作符。Lua中可重载的操作符还有许多,如:

__getindex:操作符[],支持读取访问,如 v = a[10]
__newindex:操作符[],支持赋值访问,如 a[10] = 1.22
__tostring:将变量转换成字串__add:等同于operator +
__add:操作符 +
__sub:操作符 -
__mul:操作符 ×
__div:操作符 ÷
__pow:操作符 ^ (乘方)
__unm:一元操作符 -
__concat:操作符 .. (字符串连接)
__eq:操作符 == (a ~= b等价于 not a == b)
__lt:操作符 < (a > b 等价于 b < a)
__le:操作符 <= (a >= b 等价于 b <= a,要注意的是,如果没有定义"__le",则Lua将会尝试将a<=b 转换成 not (b < a) )

__gc:在垃圾回收时调用此函数,相当于C++的析构函数。强烈建议定义此操作符,以免造成内存泄漏等情况。比如:
LUALIB_ITEM_DESTROY("__gc", MyArray )   // 垃圾收集时消除对象用。

(注) 这里要说明一下,在lua中,访问索引操作符是__index,不是__getindex,在luaWrapper库中,为了方便使用,将其映射为__getindex,同时,对__index的定义将会被忽略。

就这么简单。假如你已经有现成的类,而你没有修改该类的权力,如何将其加入到Lua中呢?答案就是,继承它,将把派生类加入到Lua中。

结束语
LuaWrapper 需要用到boost库的支持:boost/type_traits.hpp, boost/function.hpp, boost/bind.hpp,它使用了C++的模板部份特化,因此,C++编译器如果不支持此特性,将无法编译。目前支持此特性的编译器已经有很多。在VisualStudo产品系列中,只有VC7.1能支持此特性,因此,您如果正在使用VisualStudio,请确认你用的是VisualStudio2003。
如果你觉得 LuaWrapper For C++ 能够帮助你,我会感觉很荣幸。我很愿意将这个程序库分享给大家。顺便一提的是,如果你在使用过程中发现BUG,或是有好的建议,希望您能与我联系。你在使用过程中,请不要删除文件中的署名信息;如果你修改了程序库,请您在修改的文件中加入您的修改说明。当然,我会非常欢迎您能将修改后的程序回馈给我。我会继续优化并完善它。

时间: 2024-12-22 21:36:59

Lua 脚本 C++ 封装库 LuaWrapper的相关文章

用lua_tinker将lua脚本嵌入到游戏服务器

      忙中偷闲,经过几天的努力,将lua脚本嵌入到系统中.之前公司的时候,偌大一个服务器全部使用C++编写,对于新手经常发生一些宕机事件,被主程责骂.在后来接触的一些人中,发现很多公,都已经引入lua来适应多变的环境和敏捷开发!正如一个主程所说的,在n年前网易已经脚本为王了,现在很多公司拿着C++不放,作为开发人员不苦逼才怪! 想想在广州开发游戏的日子,每次在群里面看到运维说某某服务器上面有coredump文件时,总是惊出冷汗,赶紧用gdb去查询,是哪行代码引起的宕机:还要应对主程的责骂!

【COCOS2DX-LUA 脚本开发之一】LUA语言基础在COCOS2DX游戏中使用LUA脚本进行游戏开发(基础篇)并介绍脚本在游戏中详细用途!

本站文章均为 李华明Himi 原创,转载务必在明显处注明:  转载自[黑米GameDev街区] 原文链接: http://www.himigame.com/iphone-cocos2dx/681.html 对于游戏公司而言,采用游戏脚本lua.python等进行开发也很常见,但是很多童鞋对脚本并没有很熟悉的概念,本篇则向大家简单介绍脚本的用途以及在Cocos2dx基础用法: Lua和python这些详细介绍的话,请不太熟悉的童鞋自行百度百科哈,那么对于lua和python则是两个常用的脚本语言,

redis4.0之Lua脚本新姿势

前言 Redis内嵌了Lua环境来支持用户扩展功能,但是出于数据一致性考虑,要求脚本必须是纯函数的形式,也就是说对于一段Lua脚本给定相同的参数,写入Redis的数据也必须是相同的,对于随机性的写入Redis是拒绝的. 从Redis 3.2开始Lua脚本支持随机性写入,最近在总结4.0的新特性,索性就都归到4.0里,方便查阅. Redis中的Lua脚本 1. Lua脚本简介 在Redis中使用Lua脚本不可避免的要用到以下三个命令:EVAL.EVALSHA和SCRIPT,下面我们来简单介绍一下:

Java中使用Lua脚本语言(转)

Lua是一个实用的脚本语言,相对于Python来说,比较小巧,但它功能并不逊色,特别是在游戏开发中非常实用(WoW采用的就是Lua作为脚本的).Lua在C\C++的实现我就不多说了,网上随便一搜,到处都是这方面的介绍,我想说的是如何在Java下使用Lua以提高编程效率.增强你的程序可扩展性. 首先,要在Java上使用Lua脚本,必须有关于Lua脚本解释器以及Java程序可以访问这些脚本的相关API,即相关类库.我使用的是一个叫做LuaJava的开源项目,可以在: http://www.keple

【COCOS2DX-LUA 脚本开发之四】使用TOLUA++编译PKG,从而创建自定义类让LUA脚本使用

本站文章均为 李华明Himi 原创,转载务必在明显处注明:  转载自[黑米GameDev街区] 原文链接: http://www.himigame.com/lua-game/1259.html 此篇基本[COCOS2DX(2.X)_LUA开发之三]在LUA中使用自定义精灵(LUA脚本与自创建类之间的访问)及LUA基础讲解 在Lua第三篇中介绍了,如何在cocos2dx中使用Lua创建自定义类供Lua脚本调用使用,当时出于Himi对Lua研究不够深入,所以当时使用了笨方法手动添加的方式进行的,那么

Lua脚本语言入门笔记_Lua

什么是Lua Lua 是一个小巧的脚本语言.是巴西里约热内卢天主教大学(Pontifical Catholic University of Rio de Janeiro)里的一个研究小组,由Roberto Ierusalimschy.Waldemar Celes 和 Luiz Henrique de Figueiredo所组成并于1993年开发. 其设计目的是为了嵌入应用程序中,从而为应用程序提供灵活的扩展和定制功能.Lua由标准C编写而成,几乎在所有操作系统和平台上都可以编译,运行.Lua并没

sysbench自定义lua脚本实现实际的业务逻辑压力测试

使用sysbench进行mysql的oltp测试,一般的测试在sysbench中在tests/db中提供了一个oltp.lua脚本可以进行oltp的压力测试. 但不能完全模拟自己实际业务的压力测试,不同的业务,数据结构,数据量都是不一样的,为了更接近实际业务的读写压力测试,就得自己写lua脚本,然后通过sysbench进行压力测试. 写这个lua脚本很简单,只需要会写lua脚本就可以了. 1.首先收集实际业务的访问数据库的sql: 2.准备一台恢复好的备份库(从线上导一个) 3.将收集的sql写

简介Lua脚本与Redis数据库的结合使用_Redis

 可能你已经听说过Redis 中嵌入了脚本语言,但是你还没有亲自去尝试吧?  这个入门教程会让你学会在你的Redis 服务器上使用强大的lua语言.Hello, Lua! 我们的第一个Redis Lua 脚本仅仅返回一个字符串,而不会去与redis 以任何有意义的方式交互. 复制代码 代码如下: local msg = "Hello, world!" return msg 这是非常简单的,第一行代码定义了一个本地变量msg存储我们的信息, 第二行代码表示 从redis 服务端返回msg

Lua脚本语言概述_Lua

Lua是什么 Lua是一中嵌入式的脚本语言. Lua语言可以独立进行编程,但这不是其主要的使用方式.Lua虽然有动态.灵活的语法提供强大的功能,但并不像 Java.Python 等一样有一个完善的库(但仍存在一定数量的第三方库),这不是缺陷,而是和其定位有关. Lua最典型的用法,是作为一个库,嵌入 到其他大型语言(称之为宿主语言 )的应用程序之中,为应用程序提供参数配置或逻辑描述等功能,带来前所未有的灵活性. Lua常见的宿主语言有:C/C++,Java,.NET,甚至脚本语言如PHP,Rub