ToLua原理和使用教程
Tolua是用来实现C++程序中的类、变量、函数等绑定到lua程序中。绑定后lua代码可以直接调用C++程序中的类、变量、函数等等。
要想知道tolua原理,先了解tolua到底做了些什么事。先看一下下面“lua实现get/set方法”的例子。这个例子包含了三个文件luaBind.cpp文件、Main.cpp文件、a.lua文件。
luaBind.cpp文件
extern "C" {
#include "lua\lua.h"
#include "lua\lualib.h"
#include "lua\lauxlib.h"
}
const char *HandlesGetSet = "HandlesGetSet";
extern double a /*= 166*/;
int a_get(lua_State*L)
{
lua_pushnumber(L, a);
return 1;
}
int a_set(lua_State *L)
{
if (lua_isnumber(L, 1))
{
a = lua_tonumber(L, 1);
}
return 0;
}
int index_event(lua_State*L)
{
//从 registry 中获取变量的get set 方法
luaL_getmetatable(L, HandlesGetSet);
lua_pushvalue(L, 2);
lua_rawget(L, -2);
if (lua_isnil(L, -1))// 没有get set方法
{
lua_pop(L, 2);
lua_rawget(L, -2);
}
else
{
lua_pushstring(L, "get");
lua_rawget(L, -2);
lua_pcall(L, 0, 1, 0);//调用get方法
}
return 1;
}
int newindex_event(lua_State *L)
{
//从 registry 中获取变量的get set 方法
luaL_getmetatable(L, HandlesGetSet);
lua_pushvalue(L, 2);
lua_rawget(L, -2);
if (lua_isnil(L, -1))// 没有get set方法
{
lua_pop(L, 2);
lua_rawset(L, -3);
}
else
{
lua_pushstring(L, "set");//调用set方法
lua_rawget(L, -2);
lua_pushvalue(L, 3);
lua_pcall(L, 1, 0, 0);
}
return 0;
}
void BindLua(lua_State *L)
{
//获取 _G表
#if defined (LUA_VERSION_NUM) && LUA_VERSION_NUM >= 502 /* after lua 5.2 */
lua_pushvalue(L, LUA_REGISTRYINDEX); /* registry */
lua_pushnumber(L, LUA_RIDX_GLOBALS); /* registry globalsindex */
lua_rawget(L, -2); /* registry registry[globalsindex] */
lua_remove(L, -2); /* registry */
#else
lua_pushvalue(L, LUA_GLOBALSINDEX);
#endif
//创建 _G表的元表
lua_newtable(L);
lua_pushstring(L, "__index");
lua_pushcfunction(L, index_event);
lua_rawset(L, -3);
lua_pushstring(L, "__newindex");
lua_pushcfunction(L, newindex_event);
lua_rawset(L, -3);
lua_setmetatable(L, -2);//设置 _G表的元表
lua_pop(L, 1);
//创建一张表存储在 registry 中
luaL_newmetatable(L, HandlesGetSet);
//注册 a 变量的get set方法
lua_pushstring(L, "a");
lua_newtable(L);
lua_pushstring(L, "get");
lua_pushcfunction(L, a_get);
lua_rawset(L, -3);
lua_pushstring(L, "set");
lua_pushcfunction(L, a_set);
lua_rawset(L, -3);
lua_rawset(L, -3);
lua_pop(L, 1);
}
Main.cpp文件
#include
extern "C" {
#include "lua\lua.h"
#include "lua\lualib.h"
#include "lua\lauxlib.h"
}
using namespace std;
double a = 166;
void BindLua(lua_State *L);
int main()
{
lua_State *L = luaL_newstate();
luaL_openlibs(L);
BindLua(L);
a = 99;
if (0 != luaL_dofile(L, "a.lua"))
{
printf("%s\n", lua_tostring(L, -1));
}
printf("a = %f\n\n\n", a);
a = a+1000;
if (0 != luaL_dofile(L, "a.lua"))
{
printf("%s\n", lua_tostring(L, -1));
}
printf("a = %f\n", a);
lua_close(L);
return 0;
}
a.lua文件
print(a)
a = a+1
print("c=", c)
b = "adas"
print("b=", b)
这个个例子实现了将C++程序中的double a变量绑定到了lua程序中。在C++程序中改变了变量a的值,lua程序中可以获取改变后的值,同样lua程序中对变量a赋值后,C++程序也可以获取赋值后的值,具体原理参见:Lua任意类型的get/set方法, 。
三个文件的作用如下。
luaBind.cpp文件: 实现将变量double a 绑定到lua程序中
Main.cpp文件: C程序代码
a.lua文件:lua程序代码
可以看到为了绑定double a变量,luaBind.cpp中的代码并不少。为了简化这种绑定,我们可以使用tolua来实现绑定。Tolua可以帮我们生成luaBind.cpp文件,我们只需要将生成后的文件加入到程序中即可完成绑定。
要生成绑定文件,首先我们需要一个tolua++.exe的程序,然后还需要一个.pkg文件。.pkg文件是一个代码文件,代码格式与C++类似。我们首先需要编写一个pkg文件,有了这个文件之后,然后使用tolua++程序对pkg程序进行转换,转换后就就会生成相应的绑定文件。具体操作,请看后续文章。
Tulua官网http://webserver2.tecgraf.puc-rio.br/~celes/tolua/,更新到tolua-5.2.4,支持lua5.2.4。官网只提供了tolua的源代码,没有提供任何程序。
下载代码解压后,在src目录下有三个目录,如下:
Bin目录中包含了生成tolua++.exe转换程序的代码,我以使用VS2015编译,文章最后有下载地址。
Lib目录包含了程序使用tolua时需要包含的库的代码,因为代码比较少,我一般直接将lib文件夹中的代码直接包含到程序中。
Tests目录包含了tolua的一些例子,这些例子我以全部使用VS2015进行了编译,文章最后有下载地址。
在Bin目录下有两个.c文件,tolua.c、toluabind.c,将这两个文件加入到项目中,另外项目中还须要lua5.2.4代码和Lib目录下的代码。如下:
pkg文件语法,这里不讲解,具体情况tolua官网:http://webserver2.tecgraf.puc-rio.br/~celes/tolua/tolua-3.2.html。语法规则不多,与C++非常接近,很容易看懂。
这里编写一个绑定double a变量的方法。
Bindlua.pkg文件
$extern double a;
double a;
Tolua++.exe支持的命令参数。
执行以下命令生成绑定文件。
将生成的绑定文件Bindlua.cpp添加到项目中,另外还需要添加tolua源代码src/lib目录下的文件到项目中。如下:
更多有关tolua的例子请参见官方的例子,官方提供我已经转换成VS2015项目,文章结尾由相应的下载地址。
文中的代码,以及提到到tolua学习资源下载地址:https://pan.baidu.com/s/1boWtfw7