Lua中的require
来源:互联网 发布:淘宝网购鞋柜 编辑:程序博客网 时间:2024/05/16 08:48
主要翻译自lua文档,加上了programming lua中自己的一些理解
require(modname)
加载给定的模块.函数首先检查表package.loaded来判定modname是否已经存在.如果存在,则require返回package.loaded[modname]所存储的值否则它尝试为模块找到一个加载器(loader).
要找到一个加载器,require首先查询package.preloaded[modname].如果它有值,该值(应该是一个函数)就是加载器.如果没值require使用package.path中存储的路径查找一个Lua的加载器.如果该查找也失败,它使用package.cpath中存储的路径查找一个C语言加载器(C loader).如果还是失败,它尝试使用all-in-one加载器(如下)
当加载一个C库的时候,require首先使用动态链接工具将应用程序与库连接起来.之后它尝试找到一个该库中的C函数,该函数要被当做加载器使用.这个C函数的名称是字符串"luaopen_"连接着复制的模块名(模块名称中的每个点号"."都被替换为一个下划线).此外,如果模块名称含有连字符"-",则第一个连字符的前缀(包括连字符)都被移除.比如,如果模块名称是a.v1-b.c,则函数名称将是luaopen_b_c.
如果require即没有为模块找到一个Lua库也没有为模块找到一个C库,他将调用all-in-one加载器.该加载器为给定模块的根名称查找C路径找到对应库(原文:this loader searches the C path for a library for the root name of the given module).例如,当require a.b.c时,它将为a查找一个库.如果找到,它查询该库内部为子模块找到一个开放函数(open function);在我们这个例子中将会是luaopen_a_b_c.使用这个便利机制(facility),一个包可以将几个子模块打包进单个的库中,同时每个子模块保存着它本来的开放函数.
一旦找到一个加载器,require使用单个的参数modname调用加载器.如果加载器返回任何值,require将其赋值给package.loaded[modname].如果加载器没有返回值且没有给package.loaded[modname]赋与任何值,则require为该条目赋值为true.无论如何,require返回package.loaded[modname]的最终值.
如果加载或者运行模块有任何错误,或者他不能为模块找到一个加载器,则require发出一个错误信号.
require函数的实现原理如下:
--require 函数的实现function require(name)if not package.loaded[name] thenlocal loader = findloader(name)//这一步演示在代码中以抽象函数findloader来表示if loader == nil thenerror("unable to load module" .. name)endpackage.loaded[name] = truelocal res = loader(name)if res ~= nil thenpackage.loaded[name] = resendendreturn package.loaded[name]end
package.cpath
由require使用查找C加载器的路径
Lua初始化C路径package.cpath的方法与初始化Lua路径package.path的相同,使用LUA_CPATH中的环境变量(另外一个默认的路径在luaconf.h中定义)
package.loaded
一个用于控制哪些模块已经加载的表,该表由require使用.当require一个模块名为modname的模块且package.loaded[modname]不为false时,require仅返回package.loaded[modname]存储的值.
package.loadlib(libname,funcname)
使用C库libname动态链接到宿主程序.在这个库中,寻找函数funcname并将该函数作为一个C函数返回.(所以,funcname必须遵守协议(参见lua_CFunction)).
这是一个底层函数.它完全绕过了package和module系统.与require不同,它不执行任何路径查找且不自动添加扩展名.libname必须是C库中完整的文件名,如果必要的话还要包含路径和扩展名.funcname必须是原封不动的C库中导出的名字(这可能取决于使用的C编译器和链接器).
这个函数不被ANSI C支持.就其本身而言,它只在一些平台上才能使用(Windows,Linux,Mac OS X,Solaris,BSD,加上其他支持dlfcn标准的Unix系统)
package.path
require用于查找Lua加载器的路径
在启动时,Lua使用环境变量LUA_PATH或者如果环境变量未定义就使用luaconf.h中定义的默认值来初始化该值.环境变量中的任何"::"都被替换为默认路径.
路径是一系列由分号隔开的模板(templates).对于每个模板,require将每个模板中的问号替换为filename,filename是modname中每个点都被替换成"目录分隔符"(比如Unix中的"/")(这句感觉翻译不准确,原文:For each template,require will change each interrogation mark in the template by filename,which is modname with each dot replaced by a "directory separator"(such as "/" in Unix));之后他将加载产生的文件名.因此,举个例子,如果Lua路径是"./?.lua;./?.lc;/usr/local/?/init.lua",为模块foo查找一个Lua加载器将会尝试以如下顺序加载文件./foo.lua,./foo.lc和/usr/local/foo/init.lua
package.preload
为特定模块存储加载器的一个表(参见require)
package.seeall(module)
为module设置一个元表,module的__index只想全局环境(global environment),以便该module继承全局环境中的值.作为函数module中的一个选项来使用.
在Programming Lua中是这么讲的:
默认情况下,module不提供外部访问.必须在调用它之前,为需要访问的外部函数或模块声明适当的局部变量.也可以通过继承来实现外部访问,只需在调用module时附加一个选项package.seeall.这个选项等价于如下代码:
setmetatable(M,{__index = _G})因而只需这么做:
module(...,package.seeall)
module(name,[,...])
创建一个模块.如果在package.loaded[name]中有表,该表便是创建的模块.否则,如果有一个全局表t其名称与给定名称相同,则该全局表便是创建的模块.否则创建一个新的表t
- lua中的require机制
- Lua中的require
- Lua中的require
- lua中的require机制
- lua中的require机制
- Lua中的require
- lua中的require机制
- lua中的require函数
- lua中的require机制
- lua中的require机制
- lua中的require机制
- Lua中的require(二)
- Lua中的require
- lua中的require机制
- Lua中的require
- lua中的require机制【转】
- Lua中的require package.path
- Lua中的loadfile、dofile、require详解
- 交互活动
- 时光轻轻的流失
- TCP/IP 应用程序的通信连接模式
- MongoDB在Linux系统中的安装
- 扁平化设计学习之三 色彩选择
- Lua中的require
- SQL Server2005安装问题,由于计算机上的WMI配置,无法执行SQL Server系统配置检查器
- 呵呵,这年头
- 事件(Event),绝大多数内存泄漏(Memory Leak)的元凶[下篇] (提供Source Code下载
- mydoodle的开始
- C#中利用正则表达式实现字符串搜索
- iOS中如何添加自定义的字体
- pku1365 Prime Land 小整数素数分解,基础题
- 开源力量公开课