lua-使用外部模块

本是古典何须时尚 2022-08-21 02:24 340阅读 0赞

#### 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函数的实现原理如下:

**\[plain\]**  [view plain][]  [copy][view plain]

[print][view plain] [?][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  \--require 函数的实现  
2.  function require(name)  
3.      if not package.loaded\[name\] then  
4.          local loader = findloader(name) //这一步演示在代码中以抽象函数findloader来表示  
5.          if loader == nil then  
6.              error("unable to load module" .. name)  
7.          end  
8.          package.loaded\[name\] = true  
9.          local res = loader(name)  
10.         if res ~= nil then  
11.             package.loaded\[name\] = res  
12.         end  
13.     end  
14.     return package.loaded\[name\]  
15. 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.这个选项等价于如下代码:

**\[plain\]**  [view plain][]  [copy][view plain]

[print][view plain] [?][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  setmetatable(M,\{\_\_index = \_G\})

因而只需这么做:

**\[plain\]**  [view plain][]  [copy][view plain]

[print][view plain] [?][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  module(...,package.seeall)

#### module(name,\[,...\]) ####

**创建一个模块**.如果在package.loaded\[name\]中有表,该表便是创建的模块.否则,如果有一个全局表t其名称与给定名称相同,则该全局表便是创建的模块.否则创建一个新的表t

[view plain]: http://blog.csdn.net/aisajiajiao/article/details/19332397#
[CODE]: https://code.csdn.net/assets/CODE_ico.png
[CODE_CODE]: https://code.csdn.net/snippets/191041
[ico_fork.svg]: https://code.csdn.net/assets/ico_fork.svg
[ico_fork.svg 1]: https://code.csdn.net/snippets/191041/fork