Lua中調用C函數

　　Lua利用一個虛拟的堆棧來給C傳遞值或從C擷取值。每當Lua調用C函數，都會獲得一個新的堆棧，該堆棧初始包含所有的調用C函數所需要的參數值（Lua傳給C函數的調用實參），并且C函數執行完畢後，會把傳回值壓入這個棧（Lua從中拿到C函數調用結果）。

　　于此相關的C API有幾個比較重要的定義如下：

　　（1）typedef struct lua_State lua_State;

　　lua虛拟機（或叫解釋器），可以了解為一個thread，和一個完整的Lua虛拟環境的執行狀态。

　　（2）typedef int (*lua_CFunction) (lua_State *L);

　　能夠被Lua調用的C函數都必須是這種規則。函數的傳回的int值表示C函數傳回值的個數。

　　（3）void lua_pushcclosure (lua_State *L, lua_CFunction fn, int n);

　　将一個C閉包壓棧；

　　首先将upvalues依次壓棧，然後調用該函數，将c函數壓棧，并将n個upvalues出棧；

　　參數fn：C函數指針

　　參數n：函數關聯的upvalue的個數。

　　（4）void lua_pushcfunction (lua_State *L, lua_CFunction f);

　　将C函數壓棧；

　　接收一個C函數的指針參數，然後将一個Lua.function類型的對象壓棧。

　　（5）void lua_register (lua_State *L, const char *name, lua_CFunction f);

　　注冊C函數為一個全局變量；

　　#define lua_register(L,n,f) (lua_pushcfunction(L, f), lua_setglobal(L, n))

　　（6）void luaL_setfuncs (lua_State *L, const luaL_Reg *l, int nup);

　　注冊函數到棧頂的表中；

　　參數l：luaL_Reg清單，記錄了要注冊的函數資訊，注意，該清單以{NULL, NULL}結尾；

　　nup參數：upvalue的個數，如果不為0，則注冊的所有函數都共享這些upvalues；

　　先将table壓棧，然後将upvalues依次壓棧，然後調用該函數進行函數注冊。注冊完畢後upvalues會出棧。

　　注意：luaL_register函數已經不再使用，取而代之的是luaL_setfuncs，因為該函數不會建立全局變量。

　　typedef struct luaL_Reg { const char *name; lua_CFunction func; } luaL_Reg;

　　Lua可以調用C函數的能力将極大的提高Lua的可擴充性和可用性。對于有些和作業系統相關的功能，或者是對效率要求較高的子產品，我們完全可以通過C函數來實作，之後再通過Lua調用指定的C函數。對于那些可被Lua調用的C函數而言，其接口必須遵循Lua要求的形式，即typedef int (*lua_CFunction)(lua_State* L)。簡單說明一下，該函數類型僅僅包含一個表示Lua環境的指針作為其唯一的參數，實作者可以通過該指針進一步擷取Lua代碼中實際傳入的參數。傳回值是整型，表示該C函數将傳回給Lua代碼的傳回值數量，如果沒有傳回值，則return 0即可。需要說明的是，C函數無法直接将真正的傳回值傳回給Lua代碼，而是通過虛拟棧來傳遞Lua代碼和C函數之間的調用參數和傳回值的。這裡我們将介紹兩種Lua調用C函數的規則。

　　1. C函數作為應用程式的一部分

 2. C函數庫成為Lua的子產品

　　将包含C函數的代碼生成庫檔案，如Linux的so，或Windows的DLL，同時拷貝到Lua代碼所在的目前目錄，或者是LUA_CPATH環境變量所指向的目錄，以便于Lua解析器可以正确定位到他們。在我目前的Windows系統中，我将其copy到"C:\Program Files\Lua\5.1\clibs\"，這裡包含了所有Lua可調用的C庫。見如下C語言代碼和關鍵性注釋：

   見如下Lua代碼：

　　

參考：http://www.cnblogs.com/stephen-liu74/archive/2012/07/23/2469902.html