Lua标准库-模块(Modules)
包库为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,存在则直接返回当中的值,没有则通过Y定义的加载器加载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可以访问全局环境