文档章节

用LuaBridge为Lua绑定C/C++对象

shezjl
 shezjl
发布于 2015/10/26 11:13
字数 3144
阅读 229
收藏 2

【推荐】2019 Java 开发者跳槽指南.pdf(吐血整理) >>>

最近为了总结Lua绑定C/C++对象的各种方法、第三方库和原理,学习了LuaBridge库为Lua绑定C/C++对象,下面是学习笔记,实质是对该库的Reference Manual基本上翻译了一遍,学习过程中测试代码,放在我的github上。

LuaBridge的主要特点
     源码只有头文件,没有.cpp文件,没有MakeFile,使用时只需一个#include即可。
     支持不同的对象生命周期管理模式。
     对Lua栈访问方便并且是类型安全的(type-safe)。
     Automatic function parameter type binding.
     Easy access to Lua objects like tables and functions.
     LuaBridge的API是基于C++模板元编程(template metaprogramming)的。在编译时这些模板自动生成各种Lua API调用,从而可以再Lua脚本中使用C++程序中的类和函数。 为了能在C++中使用Lua的数据,比如number,string,table以及方便调用Lua的函数,使用LuaBridge中的LuaRef类,可以方便做到。

LuaBridge设计原则
     由于LuaBridge的设计目标尽可能方便使用,比如只有头文件、没有用到高级C++的语法、不需要配置。因此LuaBridge性能虽足够好,但并不是最好的,比如 OOLua(https://code.google.com/p/oolua/)执行效率就比它好,并且它也不像LuaBind(http://www.rasterbar.com/products/luabind.html)那样功能全面。 LuaBridge不支持下面特性:
     枚举型常量
     不支持8个以上的函数或方法的调用
     重载函数、方法和构造函数(Overloaded functions, methods, or constructors)
     全局变量(变量必须被包装在命名空间里)
     自动地转换STL容器类型和Table
     在Lua中继承C++类(Inheriting Lua classes from C++ classes)。
     Passing nil to a C++ function that expects a pointer or reference
     Standard containers like std::shared_ptr

在Lua访问C++
     为了在Lua中使用C++中的数据和函数,LuaBridge要求任何需要使用的数据的都需要注册。LuaBridge可以注册下面五种类型数据:
     Namespaces  一个Lua table包含了其他注册信息
     Data  全局变量或静态变量、数据成员或静态数据成员
     Functions  一般函数、成员函数或静态成员函数
     CFunctions  A regular function, member function, or static member function that uses the lua_CFunction calling convention
     Properties  Global properties, property members, and static property members. These appear like data to Lua, but are implemented in C++ using functions to get and set the values.
     Data和Properties在注册时被标记为只读(read-only)。这不同于const,这些对象的值能在C++中修改,但不能在Lua脚本中修改。

Namespaces
     LuaBridge索引的注册都是在一个namespace中,namespace是从lua角度来看的,它实质上就是table,注意这里的namespace不是C++中的namespace,C++的namespace 不是一定需要的。LuaBridge的namespace是对Lua脚本来说的,它们被作为逻辑组合工具(logical grouping tool)。为了访问Lua的全局命名空间(global namespace),可以在C++ 中,这样调用:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. getGlobalNamespace (L);  
上面的调用会返回一个对象(实质是table)可用来进一步注册,比如:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. getGlobalNamespace (L)  
  2.     .beginNamespace ("test")  
上面的调用就会在Lua的_G中创建一个名为"test"的table,现在这个table还是空的。LuaBridge保留所有以双下划线开头命名的标识,因此__test是无效的命名, 尽管这样命名LuaBridge不会报错。我们可以进一步扩展上面的注册:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. getGlobalNamespace (L)  
  2.        .beginNamespace ("test")  
  3.       .beginNamespace ("detail")  
  4.       .endNamespace ()  
  5.       .beginNamespace ("utility")  
  6.       .endNamespace ()  
  7.  .endNamespace ();  
这样注册后,我们就可以在Lua中使用test, test.detail,和test.utility。这里的引入的endNamespace函数,也会返回一个对象(实质也是table),该对象实质就是上一层namespace, 表示当前namespace注册完成。 All LuaBridge functions which create registrations return an object upon which subsequent registrations can be made, allowing for an unlimited number of registrations to be chained together using the dot operator。在一个namespace中,注册相同命名的对象,对于LuaBridge来说是没有 定义的行为。一个namespace可以多次使用增加更多的成员。比如下面两段代码是等价的:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. getGlobalNamespace (L)  
  2.   .beginNamespace ("test")  
  3.  .addFunction ("foo", foo)  
  4.   .endNamespace ();  
  5.   
  6. getGlobalNamespace (L)  
  7.   .beginNamespace ("test")  
  8.  .addFunction ("bar", bar)  
  9.   .endNamespace ();  

[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. getGlobalNamespace (L)  
  2.   .beginNamespace ("test")  
  3.  .addFunction ("foo", foo)  
  4.  .addFunction ("bar", bar)  
  5.   .endNamespace ();  

Data, Properties, Functions, and CFunctions
     Data, Properties, Functions, and CFunctions可以依次使用addVariable,, addProperty, addFunction, and addCFunction来注册。在Lua脚本中调用注册的函数时, LuaBridge会自动地传入相应的参数,并对参数类型转和检查。同样,函数的返回值也会自动处理。当前LuaBridge最多可处理8个参数。Pointers, references, and objects of class type as parameters are treated specially。如果我们在C++中有以下定义:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. int globalVar;  
  2. static float staticVar;  
  3.   
  4. std::string stringProperty;  
  5. std::string getString () { return stringProperty; }  
  6. void setString (std::string s) { stringProperty = s; }  
  7.   
  8. int foo () { return 42; }  
  9. void bar (char const*) { }  
  10. int cFunc (lua_State* L) { return 0; }  
为了在Lua使用这些变量和函数,我们可以按以下方式注册它们:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. getGlobalNamespace (L)  
  2.   .beginNamespace ("test")  
  3.  .addVariable ("var1", &globalVar)  
  4.  .addVariable ("var2", &staticVar, false)     // read-only  
  5.  .addProperty ("prop1", getString, setString)  
  6.  .addProperty ("prop2", getString)            // read only  
  7.  .addFunction ("foo", foo)  
  8.  .addFunction ("bar", bar)  
  9.  .addCFunction ("cfunc", cFunc)  
  10.   .endNamespace ();  
Variables在注册时,可以通过传递第二个参数为false,确保Variables不会在Lua被修改,默认第二个参数是true。Properties在注册时,若不传递set函数,则在脚本中是read-only。
通过上面注册后,则下面表达式在Lua是有效的:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. test        -- a namespace,实质就是一个table,下面都是table中的成员  
  2. test.var1   -- a lua_Number variable  
  3. test.var2   -- a read-only lua_Number variable  
  4. test.prop1  -- a lua_String property  
  5. test.prop2  -- a read-only lua_String property  
  6. test.foo    -- a function returning a lua_Number  
  7. test.bar    -- a function taking a lua_String as a parameter  
  8. test.cfunc  -- a function with a variable argument list and multi-return  
注意test.prop1和test.prop2引用的C++中同一个变量,然后test.prop2是read-only,因此在脚本中对test.prop2赋值,会导致运行时错误(run-time error)。在Lua按以下方式使用:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. test.var1 = 5         -- okay  
  2. test.var2 = 6         -- error: var2 is not writable  
  3. test.prop1 = "Hello"  -- okay  
  4. test.prop1 = 68       -- okay, Lua converts the number to a string.  
  5. test.prop2 = "bar"    -- error: prop2 is not writable  
  6.   
  7. test.foo ()           -- calls foo and discards the return value  
  8. test.var1 = foo ()    -- calls foo and stores the result in var1  
  9. test.bar ("Employee") -- calls bar with a string  
  10. test.bar (test)       -- error: bar expects a string not a table  

Class Objects
类的注册是以beginClass或deriveClass开始,以endClass结束。一个类注册完后,还可以使用beginClass重新注册更多的信息,但是deriveClass只能被使用一次。为了给已经用deriveClass注册的类,注册更多的信息,可以使用beginClass。
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. class A {   
  2.     public:  
  3.     A() { printf("A constructor\n");}  
  4.   
  5.     static int staticData;  
  6.     static int getStaticData() {return staticData;}  
  7.   
  8.     static float staticProperty;  
  9.     static float getStaticProperty () { return staticProperty; }  
  10.     static void setStaticProperty (float f) { staticProperty = f; }  
  11.   
  12.     static int staticCFunc (lua_State *L) { return 0; }  
  13.   
  14.     std::string dataMember;  
  15.   
  16.     char dataProperty;  
  17.     char getProperty () const { return dataProperty; }  
  18.     void setProperty (char v) { dataProperty = v; }  
  19.   
  20.   
  21.     void func1 () {printf("func1 In Class A\n"); }  
  22.     virtual void virtualFunc () {printf("virtualFunc In Class A\n");  }  
  23.   
  24.     int cfunc (lua_State* L) { printf("cfunc In Class A\n");  return 0; }  
  25. };  
  26.   
  27. class B : public A {  
  28.     public:  
  29.     B() { printf("B constructor\n");}  
  30.   
  31.     double dataMember2;  
  32.   
  33.     void func1 () {printf("func1 In Class B\n"); }  
  34.     void func2 () { printf("func2 In Class B\n"); }  
  35.     void virtualFunc () {printf("virtualFunc In Class B\n");  }  
  36. };  
  37.   
  38. int A::staticData = 3;  
  39. float A::staticProperty = 0.5;  
按下面方式注册:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1.    getGlobalNamespace (L)  
  2. .beginNamespace ("test")  
  3.     .beginClass<A>("A")  
  4.     .addConstructor <void (*) (void)> ()  
  5.     .addStaticData ("staticData", &A::staticData)  
  6.     .addStaticProperty ("staticProperty", &A::getStaticData)  
  7.     .addStaticFunction ("getStaticProperty", &A::getStaticProperty) //read-only  
  8.     .addStaticCFunction ("staticCFunc", &A::staticCFunc)  
  9.     .addData ("data", &A::dataMember)  
  10.     .addProperty ("prop", &A::getProperty, &A::setProperty)  
  11.     .addFunction ("func1", &A::func1)  
  12.     .addFunction ("virtualFunc", &A::virtualFunc)  
  13.     .addCFunction ("cfunc", &A::cfunc)  
  14.     .endClass ()  
  15.     .deriveClass<B, A>("B")  
  16.     .addConstructor <void (*) (void)> ()  
  17.     .addData ("data", &B::dataMember2)  
  18.     .addFunction ("func1", &B::func1)  
  19.     .addFunction ("func2", &B::func2)  
  20.     .endClass ()  
  21. .endNamespace ();  
注册后,可以再Lua脚本中按一下方式使用:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. local AClassObj = test.A ()  --create class A instance  
  2.   
  3. print("before:",test.A.staticData) -- access class A static member                                       
  4. test.A.staticData = 8  -- modify class A static member                                                   
  5. print("after:",test.A.staticData)                                                                        
  6.   
  7. print("before:", test.A.getStaticProperty())                                                             
  8. --test.A.staticProperty = 1.2 --error:can not modify                                                     
  9.       
  10. print("staticCFunc")  
  11. test.A.staticCFunc()  
  12.           
  13. AClassObj.data = "sting"  
  14. print("dataMember:",AClassObj.data)  
  15.           
  16. AClassObj.prop = 'a'  
  17. print("property:",AClassObj.prop)  
  18.           
  19. AClassObj:func1()  
  20.           
  21. AClassObj:virtualFunc()  
  22.           
  23. AClassObj:cfunc()  
  24.           
  25. BClassObj = test.B()  
  26.           
  27. BClassObj:func1()  
  28.       
  29. BClassObj:func2()                                                                                        
  30.                                                          
  31. BClassObj:virtualFunc()  
      
其输出结果为:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. A constructor  
  2. before: 3  
  3. after:  8  
  4. before: 0.5  
  5. staticCFunc  
  6. dataMember:     sting  
  7. property:       a  
  8. func1 In Class A  
  9. virtualFunc In Class A  
  10. cfunc In Class A  
  11. A constructor  
  12. B constructor  
  13. func1 In Class B  
  14. func2 In Class B  
  15. virtualFunc In Class B  
类的方法注册类似于通常的函数注册,虚函数也是类似的,没有特殊的语法。在LuaBridge中,能识别const方法并且在调用时有检测的,因此如果一个函数返回一个const object或包含指向const object的数据给Lua脚本,则在Lua中这个被引用的对象则被认为是const的,它只能调用const的方法。对于每个类,析构函数自动注册的。无须在继承类中重新注册已在基类中注册过的方法。If a class has a base class that is **not** registeredwith Lua, there is no need to declare it as a subclass.

Constructors
为了在Lua中,创建类的对象,必须用addConstructor为改类注册构造函数。并且LuaBridge不能自动检测构造函数的参数个数和类型(这与注册函数或方法能自动检测是不同的),因此在用注册addConstructor时必须告诉LuaBridge在Lua脚本将用到的构造函数签名,例如:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. struct A {  
  2.   A ();  
  3. };  
  4.   
  5. struct B {  
  6.   explicit B (char const* s, int nChars);  
  7. };  
  8.   
  9. getGlobalNamespace (L)  
  10.   .beginNamespace ("test")  
  11.     .beginClass <A> ("A")  
  12.       .addConstructor <void (*) (void)> ()  
  13.     .endClass ()  
  14.     .beginClass <B> ("B")  
  15.       .addConstructor <void (*) (char const*, int)> ()  
  16.     .endClass ();  
  17.   .endNamespace ()  
在Lua中,就可以一些方式,创建A和B的实例:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. a = test.A ()           -- Create a new A.  
  2. b = test.B ("hello", 5) -- Create a new B.  
  3. b = test.B ()           -- Error: expected string in argument 1  
lua_State*
有时候绑定的函数或成员函数,需要lua_State*作为参数来访问栈。使用LuaBridge,只需要在将要绑定的函数最后添加lua_State*类型的参数即可。比如:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. void useStateAndArgs (int i, std::string s, lua_State* L);                                         
  2. getGlobalNamespace (L).addFunction ("useStateAndArgs", &useStateAndArgs);  
在Lua中,就可按以下方式使用:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. useStateAndArgs(42,"hello")  
在脚本中,只需传递前面两个参数即可。注意 lua_State*类型的参数就放在定义的函数最后,否则结果是未定义的。

Class Object Types
一个注册的类型T,可能以下方式传递给Lua脚本:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. `T*` or `T&`:       Passed by reference, with _C++ lifetime_.  
  2. `T const*` or `T const&`:   Passed by const reference, with _C++ lifetime_.  
  3. `T` or `T const`:       Passed by value (a copy), with _Lua lifetime_.  

C++ Lifetime
对于C++ lifetime的对象,其创建和删除都由C++代码控制,Lua GC不能回收这些对象。当Lua通过lua_State*来引用对象时,必须确保该对象还没删除,否则将导致未定义的行为。例如,可按以下方法给Lua传递
C++ lifetime的对象:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. A a;  
  2.   
  3. push (L, &a);             // pointer to 'a', C++ lifetime  
  4. lua_setglobal (L, "a");  
  5.   
  6. push (L, (A const*)&a);   // pointer to 'a const', C++ lifetime  
  7. lua_setglobal (L, "ac");  
  8.   
  9. push <A const*> (L, &a);  // equivalent to push (L, (A const*)&a)  
  10. lua_setglobal (L, "ac2");  
  11.   
  12. push (L, new A);          // compiles, but will leak memory  
  13. lua_setglobal (L, "ap");  

Lua Lifetime
当C++通过值传递给Lua一个对象时,则该对象是Lua lifetime。在值传递时,该对象将在Lua中以userdata形式保存,并且当Lua不再引用该对象时,该对象可以被GC回收。当userdata被回收时,其相应对象的
析构函数也会被调用。在C++中应用lua lifetime的对象时,必须确保该对象还没被GC回收,否则其行为是未定义的。例如,可按以下方法给Lua传递的是Lua lifetime的催下:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. B b;  
  2.   
  3. push (L, b);                    // Copy of b passed, Lua lifetime.  
  4. lua_setglobal (L, "b");  
当在Lua中调用注册的构造函数创建一个对象时,该对象同样是Lua lifetime的,当该对象不在被引用时,GC会自动回收该对象。当然你可以把这个对象引用作为参数传递给C++,但需要保证C++在通过引用使用该对象时,
改对还没有被GC回收。

 Pointers, References, and Pass by Value
当C++对象作为参数从Lua中传回到C++代码中时,LuaBridge会尽可能做自动转换。比如,向Lua中注册了以下C++函数:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. void func0 (A a);                                                                                  
  2.         void func1 (A* a);                                                                                 
  3. void func2 (A const* a);                                                                           
  4. void func3 (A& a);                                                                                 
  5. void func4 (A const& a);  
则在Lua中,就可以按以下方式调用上面的函数:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. func0 (a)   -- Passes a copy of a, using A's copy constructor.                                     
  2. func1 (a)   -- Passes a pointer to a.                                                              
  3. func2 (a)   -- Passes a pointer to a const a.                                                      
  4. func3 (a)   -- Passes a reference to a.                                                            
  5. func4 (a)   -- Passes a reference to a const a.  
上面所有函数,都可以通过a访问对象的成员以及方法。并且通常的C++的继承和指针传递规则也使用。比如:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. void func5 (B b);                                                                                  
  2. void func6 (B* b);  
在lua中调用:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. func5 (b)   - Passes a copy of b, using B's copy constructor.                                      
  2. func6 (b)   - Passes a pointer to b.                                                               
  3. func6 (a)   - Error: Pointer to B expected.                                                        
  4. func1 (b)   - Okay, b is a subclass of a.  
当C++给Lua传递的指针是NULL时,LuaBridge会自动转换为nil代替。反之,当Lua给C++传递的nil,相当于给C++传递了一个NULL指针。

本文转载自:http://blog.csdn.net/maximuszhou/article/details/22691895?utm_source=tuicool&utm_medium=referral

上一篇: 网易开源镜像站
下一篇: app审核时间查询
shezjl
粉丝 11
博文 123
码字总数 38143
作品 0
成都
程序员
私信 提问
FFLIB之FFLUA——C++嵌入Lua&扩展Lua利器

摘要: 在使用C++做服务器开发中,经常会使用到脚本技术,Lua是最优秀的嵌入式脚本之一。Lua的轻量、小巧、概念之简单,都使他变得越来越受欢迎。本人也使用过python做嵌入式脚本,二者各有特...

知然
2013/01/27
0
0
cocos2d-x 2.2.0 如何在lua中注册回调函数给C++

cocos2d-x内部使用tolua进行lua绑定,但是引擎并没有提供一个通用的接口让我们可以把一个lua函数注册给C++层面的回调事件。 翻看引擎的lua绑定代码,我们可以仿照引擎中的方法来做。 值得吐槽...

迷途吧
09/29
0
0
Lua脚本在C++下的舞步(三)

前两天一直忙于工作,没有时间来更新,呵呵,今天赶紧补上吧。 上一讲我把Lua基本的栈规则讲了一下,然后完善了一下我的CLuaFn类。让它可以支持任意参数数量和函数名称的传值。当然,这些功能...

长平狐
2012/08/13
1K
0
C++ 跨平台多功能扩展库 - cpgf

cpgf 可为C++代码增加反射(元数据)、序列化、以及Luau和Python脚本绑定等功能,且不依赖任何外部工具。 cpgf 的目标是扩展C++语言,其中包含许多易于使用的功能,这些功能仅在其他更高级别...

wqking
2018/09/17
772
4
luabind 0.9.1版本尝试

luabind 0.9.1版本尝试 http://www.rasterbar.com/products/luabind 1. 编译luabind 0.9.1 linux版本 编译luabind需要bjam binary。 直接copy boost/1.37.0目录中编译好的bjam binary到~/bin......

zero-li
2014/01/14
369
0

没有更多内容

加载失败,请刷新页面

加载更多

超过了最大请求长度。

尝试在网站上上传视频时,出现错误“ 最大请求长度超出” 。 我该如何解决? #1楼 我认为这里没有提到它,但是要使其正常工作,我必须在web.config中提供以下两个值: 在system.web <httpRun...

javail
24分钟前
3
0
宝塔好用吗?

不少新手站长对服务器运维知识不擅长,不知道怎样管理好云服务器。如果有一个简单易用的面板,站长们就不需要去学习运维技巧,把这些就交给后端工程师就好。 宝塔算是目前市面上使用用户较多...

BirdCloud
29分钟前
4
0
第二代网关GateWay搭建流程

Spring Cloud第二代网关GateWay是由纯Netty开发,底层为Reactor,WebFlux构建,不依赖任何Servlet容器,它不同于Zuul,使用的是异步IO,性能较Zuul提升1.6倍。搭建过程如下(本次搭建的为子项目...

算法之名
32分钟前
19
0
Drools规则引擎详解-常用的drl实例

package droolsDemo//说明:每个 drl 都必须声明一个包名,这个包名与 Java 里面的不同,它不需要与文件夹的层次结构一致,//主要用于可以根据kmodule.xml中不同的package属性来指定加载...

蜗牛伊
35分钟前
5
0
如何在Android Studio中“选择Android SDK”?

将Eclipse-Android-Project成功导入“ Android Studio 1.4”后,出现错误 “请选择Android SDK” 当我单击该按钮以在模拟器中运行该应用程序时,但找不到任何方法。 当我单击“运行”时,此对...

技术盛宴
39分钟前
4
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部