先容LuaPlus:好用的Lua For C++扩展

副标题#e#

LuaPlus是Lua的C++加强，也就是说，LuaPlus自己就是在Lua的源码长举办加强得来的。用它与C++举办相助，是较量好的一个选择。

LuaPlus今朝版本为：LuaPlus for Lua 5.01 Distribution Build 1080 （February 28， 2004）。各人可以到http://luaplus.org/ 站点下载：

源码（http://wwhiz.com/LuaPlus/LuaPlus50_Build1081.zip）

方针码（http://wwhiz.com/LuaPlus/LuaPlus50_Build1081_Win32Binaries.zip）

先容LuaPlus： 好用的Lua For C++扩展　沐枫网志

[由于lua内核进级到5.1，因此，luaplus也同样随着进级。最新的luaplus可以通过svn获取，地点 svn://svn.luaplus.org/LuaPlus/work51，同时，luaplus基于5.0的内核仍然在维护更新，也可以通过svn获取，地点 svn://svn.luaplus.org/root/LuaPlus/Dev ]

我将在下面说明，如何利用LuaPlus，以及如何更利便的让LuaPlus与C++的类相助无间。

1. 挪用Lua剧本

// 建设Lua表明器：
LuaStateOwner state;

// 执行Lua剧本：
state->DoString("print('Hello World\\n')");
// 载入Lua剧本文件并执行：
state->DoFile("C:\\test.lua");
// 载入编译后的Lua剧本文件并执行：
state->DoFile("C:\\test.luac");

2. 与Lua剧本相互挪用

// 为Lua剧本配置变量
state->GetGlobals().SetNumber("myvalue", 123456);
// 得到Lua变量的值
int myvalue = state->GetGlobal("myvalue").GetInteger();

// 挪用Lua函数
LuaFunction<int> luaPrint = state->GetGlobal("print");
luaPrint("Hello World\n");

// 让Lua挪用C语言函数
int add(int a, int b){ return a+b;}
state->GetGlobals().RegisterDirect("add", add);
state->DoString("print(add(3,4))");

// 让Lua挪用C++类成员函数
class Test{public: int add(int a, int b){return a+b;}};
Test test;
state->GetGlobals().RegisterDirect("add", test, &Test::add);
state->DoString("print(add(3,4))");

#p#副标题#e#

3. 在Lua剧本中利用C++类

这个稍微有点小贫苦。不外，我包装了一个LuaPlusHelper.h的文件，它可以很轻松的完成这个事情。它的实现也很简朴，各人可以从源码上来得到如何用纯LuaPlus实现同样的成果。

不外，这里仍然有一个限制没有办理：不能利用虚成员函数。不外思量到我们仅是在Lua挪用一下C++函数，并不是要将C++完美的导入到Lua，这个限制完全可以接管。

别的，类成员变量不能直接在Lua中会见，可以通过类成员函数来会见（好比SetValue/GetValue之类）。

// 下面是一个简朴的C++类:
class Logger
{
public:
void LOGMEMBER(const char* message)
{
printf("In member function: %s\n", message);
}

Logger()
{
printf("Constructing(%p)\n", this);
v = 10;
}
virtual ~Logger()
{
printf("Destructing(%p)\n", this);
}

Logger(int n)
{
printf(" -- Constructing[%d](%p)\n", n, this);
}
Logger(Logger* logger)
{
printf(" -- Constructing[%p](%p)\n", logger, this);
logger->LOGMEMBER(" Call From Constructor\n");
}
int SetValue(int val)
{
v = val;
}
int GetValue()
{
return v;
}
public:
int v;
};

// 导入到Lua剧本：
LuaClass<Logger>(state)
.create("Logger")　// 界说结构函数 Logger::Logger()
.create<int>("Logger2")　// 界说结构函数 Logger::Logger(int)
.create<Logger*>("Logger3")　// 界说结构函数 Logger::Logger(Logger*)
.destroy("Free")　// 界说析构函数 Logger::~Logger()
.destroy("__gc")　// 界说析构函数 Logger::~Logger()
.def("lm", &Logger::LOGMEMBER)　// 界说成员函数 Logger::LOGMEMBER(const char*)
.def("SetValue", &Logger::SetValue)
.def("GetValue", &Logger::GetValue);

// 在Lua中利用Logger类(1)：
state->DoString(
"l = Logger();"　 // 挪用结构函数 Logger::Logger()
"l:lm('Hello World 1');"　 // 挪用成员函数 Logger::LOGMEMBER(const char*)
"l:Free();"　 // 挪用析构函数 Logger::~Logger()
);

#p#分页标题#e#

// 在Lua中利用Logger类(2)：
state->DoString(
"m = Logger2(10);" // 挪用结构函数 Logger::Logger(int)
"m:lm('Hello World 2');"　 // 挪用成员函数 Logger::LOGMEMBER(const char*)
"n = Logger3(m);" // 挪用结构函数 Logger::Logger(Logger*)
"n:lm('Hello World 3');"　 // 挪用成员函数 Logger::LOGMEMBER(const char*)
"m:SetValue(11);"
"print(m.GetValue());"
"m,n = nil, nil;" // m,n 将由Lua的垃极接纳来挪用析构函数
);

#p#副标题#e#

4. 将一组C函数归类到Lua模块

//同上面一样，我回收LuaPlusHelper.h来简化：
LuaModule(state, "mymodule")
.def("add", add)
.def("add2", test, add);

state->DoString(
"print(mymodule.add(3,4));"
"print(mymodule.add2(3,4));"
);

5. 利用Lua的Table数据范例

// 在Lua中建设Table
LuaObject table = state->GetGlobals().CreateTable("mytable");
table.SetInteger("m", 10);
table.SetNumber("f", 1.99);
table.SetString("s", "Hello World");
table.SetWString("ch", L"你好");
table.SetString(1, "What");

// 相当于Lua中的：
// mytable = {m=10, f=1.99, s="Hello World", ch=L"你好", "What"}

// 也可以利用table作为key和value:
state->GetGlobals().CreateTable("nexttable")
.SetString(table, "Hello")
.SetObject("obj", table);
// 相当于Lua中的：
// nexttable = {mytable="Hello", obj=mytable}

//得到Table的内容：
LuaObject t2 = state->GetGlobals("mytable");
int m = t2.GetByName("m").GetInteger();

LuaObject t3 = state->GetGlobals("nexttable");
std::string str = t3.GetByObject(t2).GetString();

6 遍历Table

LuaStateOwner state;
state.DoString( "MyTable = { Hi = 5, Hello = 10, Yo = 6 }" );

LuaObject obj = state.GetGlobals()[ "MyTable" ];
for ( LuaTableIterator it( obj ); it; it.Next() )
{
const char* key = it.GetKey().GetString();
int num = it.GetValue().GetInteger();
}

篇尾

上面我只是简朴的举一些例子来说明LuaPlus以及LuaPlusHelper的利用要领，详细文档请拜见LuaPlus.

需要下载LuaPlusHelper，请点这里：

http://files.cnblogs.com/ly4cn/LuaPlusHelper.rar

测试措施（VC7.1）：

http://files.cnblogs.com/ly4cn/LuaPlusTest.rar

原文颁发于 @ 2008年09月13日