说明:
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文件的加载执行,创建值为Nil的LuaObject,以及从Global环境中获取LuaObject、设置LuaObject到Global环境中。
创建:
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,const char *name);
int loadFile(const char *fileName,const char *mode=0);
int loadBuffer(const char *buff, size_t sz,const char *name, const char *mode=0);
int loadString(const char *s);
bool doFile(const char *fileName);
bool doString(const char *str);
bool doBuffer(const char *buff, size_t sz,const char *name);
LuaObject
LuaObject是LuaOO的核心,隐藏了所有栈的操作。可以使用LuaState中的newObject创建对象,newObject并不返回指针,而返回LuaObject对象,因为如果返回指针则需要手动去释放该对象,而返回对象后,当销毁时会调用析构会释放。当调用LuaObject的赋值函数时两个对象会有相同的引用,类似java里的对象。
LuaObject obj1=L->newObject();//创建obj1对象
LuaObject obj2=obj1;//赋值操作obj1与obj2有相同的引用,即二者指向的是同一个值。
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(const char* 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 call lua_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函数的功能。
LuaObjFunction、LuaObjFunctionVoid、LuaFunction和LuaFunctionVoid类提供的功能类似。
LuaObjFunction提供以LuaObject作为参数,并返回LuaObject的lua函数的执行,LuaObjFunctionVoid 提供以LuaObject作为参数,无返回值的lua函数的执行,LuaFunction提供以一般类型作为参数,并返回LuaObject的lua函数的执行。LuaFunctionVoid提供以一般类型作为参数,无返回值的lua函数的执行。
用法如下:
LuaFunction luafunc=L->getGlobal(“add”);
LuaObject r=luafunc(1,2);
printf(“%d”,r.toInt());