從Lua 5.1開始,我們可以使用require和module函數來獲取和創建Lua中的模塊。從使用者的角度來看,一個模塊就是一個程序庫,可以通過require來加載,之后便得到一個類型為table的全局變量。此時的table就像名字空間一樣,可以訪問其中的函數和常量,如:
復制代碼 代碼如下:
require "mod"
mod.foo()
local m2 = require "mod2"
local f = mod2.foo
f()
1. require函數:
require函數的調用形式為require "模塊名"。該調用會返回一個由模塊函數組成的table,并且還會定義一個包含該table的全局變量。在使用Lua中的標準庫時可以不用顯示的調用require,因為Lua已經預先加載了他們。
require函數在搜素加載模塊時,有一套自定義的模式,如:
復制代碼 代碼如下:
?;?.lua;c:/windows/?;/usr/local/lua/?/?.lua
在上面的模式中,只有問號(?)和分號(;)是模式字符,分別表示require函數的參數(模塊名)和模式間的分隔符。如:調用require "sql",將會打開以下的文件:
復制代碼 代碼如下:
sql
sql.lua
c:/windows/sql
/usr/local/lua/sql/sql.lua
Lua將require搜索的模式字符串放在變量package.path中。當Lua啟動后,便以環境變量LUA_PATH的值來初始化這個變量。如果沒有找到該環境變量,則使用一個編譯時定義的默認路徑來初始化。如果require無法找到與模塊名相符的Lua文件,就會找C程序庫。C程序庫的搜索模式存放在變量package.cpath中。而這個變量則是通過環境變量LUA_CPATH來初始化的。
2. 編寫模塊的基本方法:
見如下代碼和關鍵性注釋:
復制代碼 代碼如下:
--將模塊名設置為require的參數,這樣今后重命名模塊時,只需重命名文件名即可。
local modname = ...
local M = {}
_G[modname] = M
M.i = {r = 0, i = 1} --定義一個模塊內的常量。
function M.new(r,i) return {r = r, i = i} end
function M.add(c1,c2)
return M.new(c1.r + c2.r,c1.i + c2.i)
end
function M.sub(c1,c2)
return M.new(c1.r - c2.r,c1.i - c2.i)
end
--返回和模塊對應的table。
return M
3. 使用環境:
仔細閱讀上例中的代碼,我們可以發現一些細節上問題。比如模塊內函數之間的調用仍然要保留模塊名的限定符,如果是私有變量還需要加local關鍵字,同時不能加模塊名限定符。如果需要將私有改為公有,或者反之,都需要一定的修改。那又該如何規避這些問題呢?我們可以通過Lua的函數“全局環境”來有效的解決這些問題。見如下修改的代碼和關鍵性注釋:
復制代碼 代碼如下:
--模塊設置和初始化。這一點和上例一致。
local modname = ...
local M = {}
_G[modname] = M
--聲明這個模塊將會用到的全局函數,因為在setfenv之后將無法再訪問他們,
--因此需要在設置之前先用本地變量獲取。
local sqrt = mat.sqrt
local io = io
--在這句話之后就不再需要外部訪問了。
setfenv(1,M)
--后面的函數和常量定義都無需模塊限定符了。
i = {r = 0, i = 1}
function new(r,i) return {r = r, i = i} end
function add(c1,c2)
return new(c1.r + c2.r,c1.i + c2.i)
end
function sub(c1,c2)
return new(c1.r - c2.r,c1.i - c2.i)
end
--返回和模塊對應的table。
return M
4. module函數:
在Lua 5.1中,我們可以用module(...)函數來代替以下代碼,如:
復制代碼 代碼如下:
local modname = ...
local M = {}
_G[modname] = M
package.loaded[modname] = M
--[[
和普通Lua程序塊一樣聲明外部函數。
--]]
setfenv(1,M)
由于在默認情況下,module不提供外部訪問,必須在調用它之前,為需要訪問的外部函數或模塊聲明適當的局部變量。然后Lua提供了一種更為方便的實現方式,即在調用module函數時,多傳入一個package.seeall的參數,如:
復制代碼 代碼如下:
module(...,package.seeall)
注意:5.2已經不支持module了,去看看lua官網的文檔,沒有這個函數了,我用package.loaded.module_name = _ENV來創建模塊
您可能感興趣的文章:- Lua模塊與包學習筆記
- Lua中的模塊(module)和包(package)詳解
- Lua的函數環境、包實例講解
- Lua調用自定義C模塊
- Lua中使用模塊的一些基礎知識
- 使用Lua編寫Nginx服務器的認證模塊的方法
- 在Lua中使用模塊的基礎教程
- Lua極簡入門指南(六):模塊
- Lua模塊和模塊載入淺析
- Lua中的模塊與module函數詳解
- 解析Lua中的全局環境、包、模塊組織結構