2005年12月27日23:07:59
一.tolua++簡介
tolua++是一種第三方的軟件包,可以為Lua提供面向對象的特性,這樣我們就可以使用Lua來編寫使用C++語言庫的腳本文件.
二.tolua++的編譯.
tolua++的主頁在
http://www.codenix.com/~tolua/,目前的最新版本是1.0.7,為了使用tolua++,我們需要三個文件:
1.bin/tolua++[.exe] - tolua++的可執行程序
2.include/tolua++.h - tolua++的頭文件
3.lib/libtolua++.a or lib/tolua++.lib - tolua++的靜態庫(當然有的時候也需要生成動態庫,可以參考我下面給出的文章的網址,我們先從最簡單的入手)
使用tolua++的時候,都需要使用tolua++的可執行程序自動生成一個.pkg文件生成對應的.c(C語言)或者.cpp文件(C++語言),然后把這個文件和對應的C\C++文件一起編譯生成可執行程序,這樣就可以對對應的Lua腳本進行讀取操作.在后面將結合代碼例子對這個過程進行詳細的講解.
tolua++的編譯比較麻煩,官方的編譯說明需要scons這個軟件,下面介紹另一種辦法,只需要Lua就可以了(本身編寫Lua腳本文件不可能不用到Lua解釋器,所以這個算不上什么負擔了:)
說明一下,這個辦法不是我想出來的,出處在這里:
http://lua-users.org/wiki/CompilingToluappWithoutScons
官方下載的tolua++文件夾里面已經有了上面提到的1和2文件了,我在這里偷懶,就只說3的生成.
其實在上面的文檔里面寫得很清楚了,如下編譯生成靜態庫文件:
tolua++_1.0.5-1\src\lib> gcc -c *.c -I..\..\include -I <path_to_lua>\include
tolua++_1.0.5-1\src\lib> ar rcsv libtolua++.a *.o
<path_to_lua>的意思是這里輸入的是lua源代碼包的路徑,gcc中的-I參數用于指定include文件的位置.
生成了這三個文件之后,如果需要使用它們的話,需要把它們拷貝到相應的路徑.windows下面一般的會使用cygwin這個工具,以它為例說明:
1.可執行文件放在cygwin根目錄的bin目錄下
2.頭文件放在cygwin根目錄下的usr\include下面
3.靜態頭文件放在cygwin根目錄下的lib目錄下面
說明:如果沒有Lua語言的對應的可執行文件,頭文件,lib文件一樣不能使用tolua++,對于配置lua腳本解釋器的過程和上面類似.
OK,這樣一個tolua++的編譯環境就配制好了,如果你在原先安裝cygwin的時候沒有指定cygwin的可執行文件的目錄,那么對于windows下面的用戶可以在"我的電腦"-"屬性"-"高級"-"環境變量"-"Path"里面修改,
比如我在里面加入我的cygwin的bin目錄:C:\cygwin\bin,大功告成~~windows下面的用戶只用gcc的話不一定非得使用cygwin,畢竟太大了,有人喜歡使用mingw,配置的方法類似~~
三.代碼例子
tolua++的源碼包下載下來之后在根目錄的src\tests中有很多代碼例子,我們隨便找其中的tarray一組作為講解的對象.
這一組中包含的有對應的pkg文件,c文件,h文件和最后用于測試的lua腳本文件.pkg文件是用于聲明我們允許后來使用的Lua腳本使用的變量,常量,類,函數等等的一個聲明列表,這個列表中的所有東西都必須在對應的C++文件中給出來,不然是無法使用的.pkg文件的語法和C\C++的語法比較類似,可以到tolua++的官方網站上去看看,這里不再詳述.
使用pkg文件我們可以生成一個對應的C或者C++文件,可以這樣做:
tolua++ -o test.c tarray.pkg
生成的test.c就是對應的c文件,你打開這個文件看看,基本上都需要上千行的代碼.
打開tarray.c看看,為了使用Lua我們還需要作些什么,除去基本的數據的定義和main之外,還需要這些:
1.包含lua頭文件:
#include "lualib.h"
#include "lauxlib.h"
2.調用Lua腳本:
省略去不重要的部分,有這些代碼:
int tolua_tarray_open (lua_State*);
lua_State* L = lua_open();
//
.
luaopen_base(L);
tolua_tarray_open(L);
lua_dofile(L,"tarray.lua");//執行lua腳本
lua_close(L);
OK,現在來看看如何使用:
首先,生成tarray.o文件:
gcc tarray.c -c
其次,生成test.o文件:
gcc test.c tarray.h -c
最后,把兩個文件鏈接起來,注意要加入Lua和tolua++的lib文件:
gcc -o tarray.exe tarray.o test.o -llua -llualib -ltolua++
好了,現在大功告成,我們編寫一段Lua代碼調用C中的變量(源碼中帶有的tarray.lua基本上沒有任何用途:)
for i=1,10 do
print(a[i - 1])
end
for i=2,10 do
print(p[i - 1].x)
end
OK,現在在命令行下面輸入tarray.exe看看效果:
可以看到簡單的兩個循環遍歷C中的變量的效果就這樣由lua腳本實現了,很簡單,不是么:)
總結一下使用tolua++的過程:
1)編寫pkg文件生成對應的c\c++文件
2)分別編譯1)產生的文件(注意要加上對應的頭文件)和需要使用lua腳本的文件
3)編寫lua腳本,遵從lua的語法并且使用到的變量,函數,類等都是1)中聲明過的.