tolua++的源码包中有很多测试例子。这里我用更最简单的例子来学习。
第一个例子是数组。仅仅是把C++中的一个数组导出到Lua中,可以在脚本中访问并修改。
tarray.pkg文件:
$#include "tarray.h" extern int g_Arr[10]@Arr;
很简单, $#include " tarray.h ",包含实际的C头文件,这个语句会去掉$符号,直接插入到tolua++.exe生成的C文件中。文档中说$lfile,$cfile,$ifile会特别处理,我试验了下,不像说的那个样子。
extern int g_Arr[10]@Arr,tolua++会分析这一句,将g_Arr[10]映射到lua中的Arr上。其中@后面是你想在lua中看到的变量名。
tarray.h文件也只有一句:
#ifndef _TESTARRAY_H #define _TESTARRAY_H extern int g_Arr[10]; #endif
g_Arr的实例在一个cpp文件中。
用tolua++.exe生成用于导出c++对象到lua脚本中的CPP文件:
-n tarray选项指定包的名字为tarray。如果不用-n显式指定,tolua++.exe会生成一个和pkg文件名一样的包名,同时生成tolua_**_open(lua_State*)入口函数。
将此CPP文件加入工程。
在工程中加入lua5.1.lib,tolua++.lib,包含lua.hpp,tolua++.h,然后写点测试代码,就可以编译了。程序主文件array.cpp:
#include "stdafx.h" #include "lua.hpp" #include "tarray.h" int tolua_tarray_open (lua_State* tolua_S); int g_Arr[10]={0}; int _tmain(int argc, _TCHAR* argv[]) { lua_State * L = lua_open(); int i=0; for(i=0; i<10; i++) g_Arr[i] = i; luaopen_base(L); tolua_tarray_open(L); luaL_dofile(L, "../scripts/array.lua"); printf("now in c++, re-show Arr:"); for(i=0; i<10; i++) printf("%d ", g_Arr[i]); printf(" "); lua_close(L); return 0; }
luaopen_tarray_open是必须要调用的,tolua++.exe根据你命令行中指定的名字生成tolua_**_open函数。该函数用来导出c++对象到lua脚本中,所以必须在你执行lua脚本之前调用。函数的原型在由tolua++.exe生成的cpp文件中。
脚本文件array.lua内容如下:
print("now in lua script! try to print 'Arr' by name:") print(Arr) --print contents of Arr print("now print 'Arr':") for i=0,9 do print(Arr[i]) end --change contents of Arr print("now change the Arr.") for i=0,9 do Arr[i] = i*2 end
第一个例子到此为止。编译后可以进行测试了。
我针对DEBUG和release版本生成了不同的DLL和LIB文件,好用于测试。
总结一下步骤:
- 编写C头文件,定义想导出的对象
- 编写pkg文件,包含之前的C头文件,用tolua++可识别的规则定义你要导出的对象
- 用tolua++.exe生成CPP文件
- 将3生成的文件,1中的头文件,tolua++的头文件,lua的头文件及相关的库加入工程。
- 编写lua脚本文件。