Lua　标准库 - 模块(Modules)

来源：来自ITPUB论坛

?

包库为Lua提供简易的加载及创建模块的方法，由require、module方法及package表组成

　　1、module (name [,···])

　　功能：建立一个模块。

　　当package.loaded[name]中存在时，当中的表作为module;

　　当在全局表中存在name指定的表时，此表作为module;

　　当以前两种情况都不存表name时，将新建一个表，并使其作为全局名name的值，并package.loaded[name],而且设t._NAME为name,t._M为module,t._PACKAGE为包的全名(模块名-组件a.b.c);最后把此module设t作为当前函数的新环境表和package.loaded[name]的新值(也就是说，旧的环境表将不能访问,除了加上package.seeall参数外)，以被require使用

　　module(name)后的可选参数为接收module名的函数,如package.seeall

　　2、require (modname)

　　功能：加载指定的模块。

　　此函数先检测package.loaded表中是否存在modname，存在则直接返回当中的值，没有则通过郰定义的加载器加载modname。

　　查找加载器顺序：

　　(1)检测package.preload表是否存在modname，有则加载

　　(2)通过Lua Loader加载,通过查找存放于package.path的路径加载，有则加载

　　(3)通过C Loader加载，通过查找存放于package.cpath的路径加载，有则加载

　　(4)通过all-in-one Loader加载：

　　通过查找modname.dll并查找当中的luaopen_

　　其中XXXX为载块名-后的字符用_替换.后的字符:如：a.v1-b.c 当函数名为luaopen_b_c

　　当require查找的不是一个Lua库或C库，它就会调用all-in-one loader,此加载器是用C路径作为载块的目录，

　　当查找到合适的加载器时，require就会加载其中的模块，当加载器有返回值，将会存放于package.loaded[modname]表。最后返回package.loaded[modname]表

　　当加载失败时，require将触发错误

　　3、package.cpath

　　功能：用于require　C loader的搜索路径

　　可以通过修改LUA_CPATH变量(luaconf.h)修改此值

　　4、package.loaded

　　功能：一个用于让require知道哪些模块已加载的记录表，如果package.loaded已经有require要的值，则直接返回此值

　　5、package.loadlib (libname,funcname)

　　功能：通过动态连接C函数库方式加载Lua扩展库

　　libname为库文件名，funcname为入口函数(此函数必须为纯C接口函数 c++则需用 extern "C" {} 进行限制)

　　6、package.path

　　功能：用于require　Lua loader的搜索路径

　　可以通过修改LUA_PATH变量(luaconf.h)修改此值

　　7、package.preload

　　功能：一个用于保存特殊模块加载器的表

　　8、package.seeall(module)

　　功能：为module设置一个元表，此元表的__index字段的值为全局环境_G。所以module可以访问全局环境

　　注：以此函数作为module()的一个选项(详细见module()