LuaOO (Lua与C++交互的面向对象封装)

来源:互联网 发布:cocos2d js api 中文 编辑:程序博客网 时间:2024/05/16 13:43

说明:

LuaOO是Lua C API使用C++语言的面向对象封装。LuaOO是在lua原有的API基础之上扩展而来,极少地修改lua源码,主要是通过扩展lua原来的代码。扩展lua与C++环境交互。因此当有新版本的lua源码发布时也能够支持。LuaOO的很多接口的命名与lua API类似。LuaOO隐藏了lua栈的操作,LuaOO库将不会提供类似lua_gettop,lua_settop,lua_pushvalue,lua_remove,lua_insert等对栈的操作的接口。

LuaOO主要的类有

 

所有的LuaOO对象都在命名空间lua

 

LuaState

 

主要封装lua的初始化、关闭,.Lua文件的加载执行,创建值为NilLuaObject,以及从Global环境中获取LuaObject、设置LuaObjectGlobal环境中。

 

创建:

l         LuaState *L=LuaState::create();

关闭:

l         L->release();//该会自动回收内存,不要调用delete L来删除

 

切勿在栈上定义LuaState

不建议如下的使用:

LuaState LS;

LS.release();

 

其他操作

    LuaObject newObject();//创建object

    LuaObject getGlobal(const char *name);

    void setGlobal(LuaObject &obj,constchar *name);

 

    int loadFile(constchar *fileName,constchar *mode=0);

int loadBuffer(constchar *buff, size_t sz,constchar *name, constchar *mode=0);

    int loadString(constchar *s);

    bool doFile(constchar *fileName);

    bool doString(constchar *str);

    bool doBuffer(constchar *buff, size_t sz,constchar *name);

   


LuaObject

 

LuaObjectLuaOO的核心,隐藏了所有栈的操作。可以使用LuaState中的newObject创建对象,newObject并不返回指针,而返回LuaObject对象,因为如果返回指针则需要手动去释放该对象,而返回对象后,当销毁时会调用析构会释放。当调用LuaObject的赋值函数时两个对象会有相同的引用,类似java里的对象。

LuaObject obj1=L->newObject();//创建obj1对象

LuaObject obj2=obj1;//赋值操作obj1obj2有相同的引用,即二者指向的是同一个值。

obj1.setNumber(123);//设置obj1的值为123

obj2.toNumber()//获得123

 

如果想获得一份obj1的拷贝则可以调用clone函数

LuaObject obj2=obj1.clone();

obj1.setNumber(123);//设置obj1的值为123

obj2.toNumber()//不会得到123,因为obj2的值依然是Nil

 

LuaObject对象创建后默认值是Nil,可以调用set*()函数来设置相应的值,调用is*()来判断值的类型。调用to*()可以获取值。

    LuaObject o1=L->newObject();

    o1.setString("Hello world!!!");

    LuaObject o2= L->newObject();

    o2.setUInt(12345);

       printf(o1.toString());//打印字符Hello world!!!

 

支持设置C++函数到LuaObject

如下:

 

void test()

{

       printf(“Hello”);

}

 

 

LuaObject f=L->newObject();

f.setFunction(test);

L->setGlobal(f,test);

 

可以在lua环境中调用test()函数

test.lua文件内容

test()

 

L->doFile(test.lua);

输出Hello

 

class Test

{

public:

       void test()

{

       printf(“Test::test”);

}

 

};

 

Test t;

LuaObject f2=L->newObject();

f.setFunction(t,test);

L->setGlobal(f,test2);

 

可以在lua环境中调用test2()函数

输出Test::test

 

对表的操作如下:

    bool addTable(constchar* key,LuaObject &obj);

    bool addTable(int key,LuaObject &obj);

    LuaObject getTable(const char* key);

    LuaObject getTable(int key);

 

LuaObject table=L->newObject();

table.setTable(0,0);

 

table.addTable(o1,o1);

 

LuaObject g=L->newObject();

g=table.getTable(“o1”);

 

可以为LuaObject设置metaTable

调用   

LuaObject getMetaTable();

    void setMetaTable(const LuaObject &metaTable);

来完成

    LuaObject mt=L->newObject();

    mt.setTable(10,0);//Table

       mt.addTable(“data”,o1);

       LuaObject obj=L->newObject();

       obj. getMetaTable(mt);

       调用setMetaTable()就可以获取MetaTable了

 

LuaIterator类

 

对表的遍历可以使用该类使用如下

如果key的类型为数字调用key().toString()会导致遍历的失败

见lua 说明文档

While traversing a table, do not calllua_tolstring directly on a key, unless you know that the key is actually a string. Recall that lua_tolstring may change the value at the given index; this confuses the next call to lua_next.

 

    LuaObject k=L->newObject();

 

    LuaIterator I=table.begin(k);

   

    while(I.next())

    {

       printf("key=%d\t",I.key().toString());

       printf("value=%s\n",I.value().toString());

    }

 

LuaFunction类

该类用于实现在C++环境中调用lua函数的功能。

LuaObjFunctionLuaObjFunctionVoidLuaFunctionLuaFunctionVoid类提供的功能类似。

LuaObjFunction提供以LuaObject作为参数,并返回LuaObjectlua函数的执行,LuaObjFunctionVoid提供以LuaObject作为参数,无返回值的lua函数的执行,LuaFunction提供以一般类型作为参数,并返回LuaObjectlua函数的执行。LuaFunctionVoid提供以一般类型作为参数,无返回值的lua函数的执行。

 

用法如下:

LuaFunction luafunc=L->getGlobal(“add”);

LuaObject r=luafunc(1,2);

printf(“%d”,r.toInt());

 

点击下载链接库

原创粉丝点击