将Lua嵌入到自己的程序中

什么是Lua

Lua是具有简单数据描述的扩展编程语言(动态解析语言)。它提供了非常好的面向对象编程， 函数式编程(functional programming)，数据驱动式编程(data-driven programming)， 它可以作为一个强大、轻量的脚本语言，供任何需要的程序使用。 Lua 以一个用 clean C 写成的库形式提供。（所谓 Clean C ，指的 ANSI C 和 C++ 中共通的一个子集）

Lua例子(FOR 循环)

 
   

  
    
for i=1,10 do

    -- the first program in every language

    io.write("Hello world, from ",_VERSION,"!\n")

end




 
   

详细描述可以参考Lua网站http://www.lua.org/about.html

背景

本例子是WTL程序（简单的HTML帮助系统），结合Lua脚本作为参数和内容的定制。
定义的Lua函数如下：

 
   

  
    
-- # MessageBox

--------------------------------------------------------

-- int MessageBox(

-- string msg, |= Message to display

-- string capition |= Capition of Box

-- );

-- Return Value:

-- if 1 the user click in OK or user close the box





-- # ShowContentPainel

-----------------------------------------------------------------

-- void ShowContentPainel(

-- bool bShow |= If true, the painel start opened, if false not.

-- );



-- # SetWindowStartSize

-----------------------------------------------------------------

-- void SetWindowStartSize(

-- number w, |= Start W size of window

-- number h, |= Start H size of window

-- );

-- Remarks:

-- if this function is not called, the default size is 800 x 600



-- # SetMinWindowSize

-----------------------------------------------------------------

-- void SetMinWindowSize(

-- number w, |= Minimum W size of window

-- number h, |= Minimum H size of window

-- );



-- # SetTitle

-----------------------------------------------------------------

-- void SetTitle(

-- string title |= Text that be title of window.

-- );



-- # Navigate

-----------------------------------------------------------------

-- void Navigate(

-- string url |= Url

-- );



-- # InsertItemInPainel

-----------------------------------------------------------------

-- void InsertItemInPainel(

-- string title, |= Text displayed in tree

-- string url, |= Url

-- number icon, |= Icon of item, the possible values 

                           ---are: 0 = BOOK, 1 = FILE, 2 = NETFILE

-- number id, |= Id of item, this has to be unique and start in 1

-- number idp |= Parent item, this is a ID of a item that is 

                                ---the parent or '0' for root item.

-- );

-- sample:

-- ICON BOOK / ID 1 / In ROOT

-- InsertItemInPainel("Trinity Systems", 

            "http://www.novaamerica.net/trinitysystems/", 0, 1, 0); 

-- ICON NETFILE / ID 2 / In ID1 (Trinity Systems)

-- InsertItemInPainel("Orion", 

       "http://www.novaamerica.net/trinitysystems/Orion", 2, 2, 1); 



-- # ExpandItemInPainel

------------------------------------------------------------------

-- void ExpandItemInPainel(

-- string id |= Id of item

-- );

-- Remarks:

-- This function need to be called after InsertItemInPainel's




 
   

现在我将展示如何使用Lua/C++创建这些函数。

代码

首先要做的是创建含Lua的DLL

在工程里做如下链接：

 
   

  
    
//

// For sample:

//

//---------------------------------------------

// Library Linkage

//---------------------------------------------

//-

#if defined (_DEBUG)

#pragma comment( lib, "lua.lib" ) // Lua Support

#else

#pragma comment( lib, "lua.lib" ) // Lua Support

#endif

//-




 
   

记得：要更改项目的属性Project Property -> linker -> general -> additional library directory
到lua lib所在目录。

添加Lua包含文件：

 
   

  
    
extern "C" 

{

#include "lua.h"

}




 
   

记得：要更改项目的属性 Project Property -> C/C++ -> general -> additional include directories
到lua include所在目录。
注意：lua lib里的所有文件保持"c"的扩展名，因为Lua采用ANSI C编写。

现在我们需要按如下方式启动Lua VM

 
   

  
    
LRESULT OnCreate(UINT 

/*uMsg*/, WPARAM /*wParam*/, LPARAM /*lParam*/, BOOL& 

/*bHandled*/)

{

//...

// Lua

//

lua_State *luaVM = lua_open(); /* 

Open Lua */

//

luaopen_base(luaVM );     /* opens the 

basic library */

luaopen_table(luaVM );    /* opens the table 

library */

luaopen_io(luaVM );       /* opens 

the I/O library */

luaopen_string(luaVM );   /* opens the string 

lib. */

luaopen_math(luaVM );     /* opens the math lib. 

*/

if (NULL == 

luaVM)

{

         

MessageBox("Error Initializing lua\n");

}

//...

// Do things with lua 

code.

// see below

//...

lua_close(luaVM); /* Close Lua */

//

// 

End

//...

}




 
   

现在我们写Lua 和 C/C++ 结合的函数

Lua API函数可以这样写：

lua_register(s, n, g)

这里：
s:是lua_State
n:暴露给Lua的函数名称
g: C/C++中的结合函数

请看下面例子：

 
   

  
    
//...

// Do things with 

lua code.

lua_register( luaVM, "SetHome", l_SetHome );

//...

// 

-------------------------------------------

// 

#Lua Functions

// 

------------------------------------------

//

static 

int l_SetTitle( lua_State* 

luaVM)

{

         const char* 

title = luaL_checkstring(luaVM, 

1);

         

theMainFrame->SetWindowText(title);

         

return 0;

}




 
   

现在我们需要加载并执行Lua脚本

 
   

  
    
//...

// Do things with lua 

code.

lua_register( luaVM, "SetHome", l_SetHome );

//more glue 

functions

lua_dofile(luaVM, "hrconf.lua");

//...




 
   

执行Lua API函数可以这样：

lua_dofile(s, p)

这里：
s: 是lua_State
p: 是Lua脚本文件

为了完全理解Lua API,可以参考Lua 参考手册http://www.lua.org/manual/5.1/manual.html

兴趣点：
Lua是免费软件free software
下载Lua:http://www.lua.org/download.html
手册：http://www.lua.org/manual/5.1/
参考：http://www.lua.org/
VC知识库：http://www.vckbase.com/