lua學習筆記之四(Lua中的基本函數庫) · Lua學習筆記

### Lua中的基本函數庫表1 <table border="1" cellspacing="0" cellpadding="0"><tbody><tr><td valign="top" style="background:#99CCFF">基本函數庫</td><td valign="top" style="background:#99CCFF">功能</td><td valign="top" style="background:#99CCFF">參數</td><td valign="top" style="background:#99CCFF">備注</td></tr><tr><td valign="top">assert(v[,mess age]) ? ? ? ? ? ? ? ??</td><td valign="top">相當于C的斷言</td><td valign="top">v：當表達式v為nil或false將觸發錯誤,message：發生錯誤時返回的信息，默認為"assertion failed!"</td><td valign="top">?</td></tr><tr><td valign="top">collectgarbage (opt [, arg])</td><td valign="top">是垃圾收集器的通用接口，用于操作垃圾收集器</td><td valign="top">opt：操作方法標志"Stop": 停止垃圾收集器 "Restart": 重啟垃圾收集器 "Collect": 執行一次全垃圾收集循環"Count": 返回當前Lua中使用的內存量(以KB為單位)"Step": 單步執行一個垃圾收集. 步長 "Size" 由參數arg指定　(大型的值需要多步才能完成)，如果要準確指定步長，需要多次實驗以達最優效果。如果步長完成一次收集循環，將返回True"Setpause": 設置 arg/100 的值作為暫定收集的時長 "Setstepmul": 設置 arg/100 的值，作為步長的增幅(即新步長＝舊步長*arg/100)</td><td valign="top">?</td></tr><tr><td valign="top">dofile (filename)</td><td valign="top">打開并且執行一個lua塊,當忽略參數filename時，將執行標準輸入設備(stdin)的內容。返回所有塊的返回值。當發生錯誤時，dofile將錯誤反射給調用者</td><td valign="top">注：dofile不能在保護模式下運行</td><td valign="top">?</td></tr><tr><td valign="top">error (message [, level])</td><td valign="top">終止正在執行的函數，并返回message的內容作為錯誤信息(error函數永遠都不會返回)</td><td valign="top">通常情況下，error會附加一些錯誤位置的信息到message頭部.Level參數指示獲得錯誤的位置,Level=1[默認]：為調用error位置(文件+行號)Level=2：指出哪個調用error的函數的函數Level=0:不添加錯誤位置信息</td><td valign="top">?</td></tr><tr><td valign="top">_G全局環境表(全局變量)</td><td valign="top">記錄全局環境的變量值的表 _G._G = _G</td><td valign="top">?</td><td valign="top">?</td></tr><tr><td valign="top">getfenv(f)</td><td valign="top">返回函數f的當前環境表</td><td valign="top">f可以為函數或調用棧的級別，級別1[默認]為當前的函數,級別0或其它值將返回全局環境_G</td><td valign="top">?</td></tr><tr><td valign="top">getmetatable(object)</td><td valign="top">返回指定對象的元表(若object的元表.__metatable項有值，則返回object的元表.__metatable的值)，當object沒有元表時將返回nil</td><td valign="top">?</td><td valign="top">?</td></tr><tr><td valign="top">ipairs (t)?</td><td valign="top">返回三個值迭代函數、表、0多用于窮舉表的鍵名和鍵值對如：for i,v in ipairs(t) do ? end每次循環將索引賦級i，鍵值賦給v</td><td valign="top">注：本函數只能用于以數字索引訪問的表如：t={"1","cash"}</td><td valign="top">?</td></tr><tr><td valign="top">load (func [, chunkname])</td><td valign="top">裝載一個塊中的函數，每次調用func將返回一個連接前一結的字串，在塊結尾處將返回nil當沒有發生錯誤時，將返回一個編譯完成的塊作為函數,否則返回nil加上錯誤信息，此函數的環境為全局環境chunkname用于錯誤和調試信息</td><td valign="top">?</td><td valign="top">?</td></tr><tr><td valign="top">loadfile ([filename])</td><td valign="top">與load類似，但裝載的是文件或當沒有指定filename時裝載標準輸入(stdin)的內容</td><td valign="top">?</td><td valign="top">?</td></tr><tr><td valign="top">loadstring (string [, chunkname])</td><td valign="top">與load類似，但裝載的內容是一個字串如：assert(loadstring(s))()</td><td valign="top">?</td><td valign="top">?</td></tr><tr><td valign="top">next (table [, index])</td><td valign="top">允許程序遍歷表中的每一個字段，返回下一索引和該索引的值。</td><td valign="top">table：要遍歷的表index：要返回的索引的前一索中的號，當index為nil[]時，將返回第一個索引的值，當索引號為最后一個索引或表為空時將返回nil注：可以用next(t)來檢測表是否為空(此函數只能用于以數字索引的表與ipairs相類似)</td><td valign="top">?</td></tr><tr><td valign="top">ipairs (t)</td><td valign="top">返回三個值 next函數、表、0多用于窮舉表的鍵名和鍵值對如：for n,v in pairs(t) do end</td><td valign="top">每次循環將索引賦級i，鍵值賦給v注：本函數只能用于以鍵名索引訪問的表如：t={id="1",name="cash"}</td><td valign="top">?</td></tr><tr><td valign="top">pcall (f, arg1, ···)</td><td valign="top">在保護模式下調用函數(即發生的錯誤將不會反射給調用者)當調用函數成功能返回true,失敗時將返回false加錯誤信息</td><td valign="top">?</td><td valign="top">?</td></tr><tr><td valign="top">print (···)</td><td valign="top">簡單的以tostring方式格式化輸出參數的內容</td><td valign="top">?</td><td valign="top">?</td></tr><tr><td valign="top">rawequal (v1, v2)</td><td valign="top">檢測v1是否等于v2，此函數不會調用任何元表的方法</td><td valign="top">?</td><td valign="top">?</td></tr><tr><td valign="top">rawget (table, index)</td><td valign="top">獲取表中指定索引的值，此函數不會調用任何元表的方法，成功返回相應的值，當索引不存在時返回nil</td><td valign="top">注：本函數只能用于以數字索引訪問的表如：t={"1","cash"}</td><td valign="top">?</td></tr><tr><td valign="top">rawset (table, index, value)</td><td valign="top">設置表中指定索引的值，此函數不會調用任何元表的方法，此函數將返回table</td><td valign="top">?</td><td valign="top">?</td></tr><tr><td valign="top">select (index, ···)</td><td valign="top">當index為數字將返回所有index大于index的參數:如：select(2,"a","b") 返回 "b"當index為"#"，則返回參數的總個數(不包括index)</td><td valign="top">?</td><td valign="top">?</td></tr><tr><td valign="top">setfenv (f, table)</td><td valign="top">設置函數f的環境表為table</td><td valign="top">f可以為函數或調用棧的級別，級別1[默認]為當前的函數,級別0將設置當前線程的環境表</td><td valign="top">?</td></tr><tr><td valign="top">setmetatable (table, metatable)</td><td valign="top">指定的table設置元表metatable，如果metatable為nil則取消table的元表，當metatable有__metatable字段時，將觸發錯誤</td><td valign="top">注：只能為LUA_TTABLE表類型指定元表</td><td valign="top">?</td></tr><tr><td valign="top">tonumber (e [, base])</td><td valign="top">嘗試將參數e轉換為數字，當不能轉換時返回nil</td><td valign="top">base(2~36)指出參數e當前使用的進制，默認為10進制，如tonumber(11,2)=3</td><td valign="top">?</td></tr><tr><td valign="top">tostirng(e)</td><td valign="top">將參數e轉換為字符串，此函數將會觸發元表的__tostring事件</td><td valign="top">?</td><td valign="top">?</td></tr><tr><td valign="top">type(v)</td><td valign="top">返回參數的類型名("nil"，"number", "string", "boolean", "table", "function", "thread", "userdata")</td><td valign="top">?</td><td valign="top">?</td></tr><tr><td valign="top">unpack (list [, i [, j]])</td><td valign="top">返回指定表的索引的值,i為起始索引，j為結束索引</td><td valign="top">注：本函數只能用于以數字索引訪問的表,否則只會返回nil如：t={"1","cash"}</td><td valign="top">?</td></tr><tr><td valign="top">_VERSION</td><td valign="top">返回當前Lua的版本號"Lua 5.1".</td><td valign="top">?</td><td valign="top">?</td></tr><tr><td valign="top">xpcall (f, err)</td><td valign="top">與pcall類似，在保護模式下調用函數(即發生的錯誤將不會反射給調用者)但可指定一個新的錯誤處理函數句柄當調用函數成功能返回true,失敗時將返回false加err返回的結果</td><td valign="top">?</td><td valign="top">?</td></tr></tbody></table> 引用博客:http://www.cnblogs.com/whiteyun/archive/2009/08/12/1543184.html