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