ulua 路径小记 以及 lua require 机制整理
2016-08-16 00:25
295 查看
ulua 路径小记
在学习ulua时,require模块的根路径可以为项目的Lua文件夹或者ToLua文件夹(Editor下),但是在
package.path和
package.cpath中并没有看到当前项目的路径,那require是如何找到Lua和ToLua文件夹的路径的呢?
* ulua在初始化
LuaState时,会先解析
package.path, 并将其存入
LuaFileUtils的
SearchPaths中(LuaState.cs line:603),并将Lua和ToLua的目录添加其中(LuaState.cs line:187)。
* 在LuaState的构造函数中,会调用
ToLua.OpenLib(T),该方法定义了一下特殊方法,可以在lua中使用,如
typeof等。
*
OpenLib方法会在
package.loaders数组中,再添加一个loader,并且将其放到数组的第二个位置。(ToLua.cs line:192)注:Lua require模块时,会依次调用package.loader中的方法,找到则返回
* loader的作用就是检测传入的文件名(module名),是否在
LuaFileUtils的
SearchPaths,如果存在就读取文件,若不存在则返回空(LuaFileUitls.cs line:170)
Lua require 相关整理(基于lua 5.1)
摘自http://cloudwu.github.io/lua53doc/manual.html#6.3根据lua5.1 手册做了部分修改
package.preload
为指定的模块,设置loader,在require模块时,先去查询这张表,如果有值,则使用preload中的loader(可以用于修改特殊模块的加载策略)package.path
这个路径被 require 在 Lua 加载器中做搜索时用到。在启动时,Lua 用环境变量
LUA_PATH来初始化这个变量。 或采用
luaconf.h中的默认路径。 环境变量中出现的所有 “
;;” 都会被替换成默认路径。
package.cpath
这个路径被require在 C 加载器中做搜索时用到。
Lua 用和初始化 Lua 路径
package.path相同的方式初始化 C 路径
package.cpath。 它会使用环境变量
LUA_CPATH初始化。 要么就采用
luaconf.h中定义的默认路径。
package.loaders(Lua5.3中, 改名为searchers)
用于require控制如何加载模块的表。
这张表内的每一项都是一个 查找器函数。 当查找一个模块时,
require按次序调用这些查找器, 并传入模块名(
require的参数)作为唯一的一个参数。 此函数可以返回另一个函数(模块的 加载器)加上另一个将传递给这个加载器的参数。 或是返回一个描述为何没有找到这个模块的字符串 (或是返回 nil 什么也不想说)。
Lua 用四个查找器函数初始化这张表。
第一个查找器就是简单的在
package.preload表中查找加载器。
第二个查找器用于查找 Lua 库的加载库。 它使用储存在
package.path中的路径来做查找工作。路径是一个包含有一系列以分号分割的 模板 构成的字符串。 对于每个模板,都会用
name替换其中的每个问号(如果有的话)。 且将其中的 点替换为系统的目录分割符(如 Unix中的”/”)。 然后尝试打开这个文件名。
例如,如果路径是字符串
"./?.lua;./?.lc;/usr/local/?/init.lua"
搜索
foo.a这个名字将 依次尝试打开文件
./foo/a.lua,
./foo/a.lc,以及
/usr/local/foo/a/init.lua。
第三个查找器用于查找 C 库的加载库。 它使用储存在
package.cpath中的路径来做查找工作。 例如,如果 C 路径是这样一个字符串
"./?.so;./?.dll;/usr/local/?/init.so"
查找器查找模块
foo会依次尝试打开文件
./foo.so,
./foo.dll, 以及
/usr/local/foo/init.so。 一旦它找到一个 C 库, 查找器首先使用动态链接机制连接该库。 然后尝试在该库中找到可以用作加载器的 C 函数。 这个 C 函数的名字是 “
luaopen_” 紧接模块名的字符串, 其中字符串中所有的下划线都会被替换成点。 此外,如果模块名中有横线, 横线后面的部分(包括横线)都被去掉。 例如,如果模块名为
a.b.c-v2.1, 函数名就是
luaopen_a_b_c。
第四个搜索器是 一体化加载器。 它从 C 路径中查找指定模块的根名字。 例如,当请求
a.b.c时, 它将查找
a这个 C 库。 如果找得到,它会在里面找子模块的加载函数。 在我们的例子中,就是找
luaopen_a_b_c。 利用这个机制,可以把若干 C 子模块打包进单个库。 每个子模块都可以有原本的加载函数名。
require(modname)
加载一个模块。 这个函数首先查找package.loaded表, 检测
modname是否被加载过。 如果被加载过,
require返回
package.loaded[modname]中保存的值。(防止重复加载) 否则,它试着为模块寻找 加载器 。
首先
require查找
package.preload[modname]。 如果这里有一个值,这个值(必须是一个函数)就是那个加载器。 否则
require使用 Lua 加载器去查找
package.path的路径。 如果查找失败,接着使用 C 加载器去查找
package.cpath的路径。 如果都失败了,再尝试 一体化 加载器 (参见
package.loaders。
每次找到一个加载器,
require都用一个参数调用加载器:
modname。 如果加载器返回非空值,
require将这个值赋给
package.loaded[modname]。 如果加载器没能返回一个非空值用于赋给
package.loaded[modname],
require会在那里设入 true 。 无论是什么情况,
require都会返回
package.loaded[modname]的最终值。
如果在加载或运行模块时有错误, 或是无法为模块找到加载器,
require都会抛出错误。
相关文章推荐
- 详解Lua中的表的概念及其相关操作方法
- Lua编程示例(二):面向对象、metatable对表进行扩展
- 把Lua编译进nginx步骤方法
- Lua脚本自动生成APK包
- Lua中的元表(metatable)、元方法(metamethod)详解
- Lua中的metatable介绍
- Lua中ipair和pair的区别
- Lua中的函数精讲笔记
- 浅谈Lua的面向对象特性
- 详解Lua中的变量相关知识点
- Lua脚本语言入门笔记
- Lua脚本调用外部脚本
- 详解Lua中的if语句的使用方法
- Lua中调用函数使用点号和冒号的区别
- Lua中的闭合函数、非全局函数与函数的尾调用详解
- Lua中强大的元方法__index详解
- Lua中调用C++函数示例
- Lua面向对象之类和继承浅析
- Lua性能优化技巧(一):前言
- Lua中获取table长度问题探讨