lua cjson
呼延高超
Lua CJSON、2.1.0版本、MIT协议
支持UTF-8，不支持UTF-16和UTF-32。 #没有任何影响。
支持Lua-5.1、Lua-5.2、LuaJIT。
【安装】
方法一：修改Makefile设置PREFIX变量为/usr/local/lua，然后执行make install即可。
方法二：执行make，然后cp cjson.so $LUA_MODULE_DIRECTORY即可。
【使用】
模块实例化：
> local cjson = require "cjson"
Lua CJSON不会自动创建一个模块table的全局变量，要自己赋给一个叫"cjson"的变量。
> local cjson2 = cjson.new()
创建一个cjson模块的独立副本给cjson2，可以拥有各自不同的encoding buffer和默认配置。
> local cjson_safe = require "cjson.safe"
cjson.safe模块几乎与cjson模块一样，只是cjson只能在JSON转码过程中立即报错，而cjson.safe则不会立即报错，而是返回nil和一条错误信息。
解码(decode)：
> json_text = '[true, {"foo":"bar"}]'
> lua_value = cjson.decode(json_text) => Returns: {true, {foo="bar"}}
cjson.decode会把一个UTF-8的JSON字符串转为一个Lua value或table，JSON中的null会转为一个空的lightuserdata，可以与cjson.null进行比较，如果JSON中的key为数字，会自动转为字符串存储。
> setting = cjson.decode_invalid_numbers(setting) #setting为true或false,默认为true
当解码一个JSON不支持的数字(infinity，NaN或hexadecimal)时，JSON会报错。默认setting为true，允许接收并解码非法数字，如果setting为false，就会报错。
> depth = cjson.decode_max_depth([depth]) #depth为正整数，默认为1000层。
为了防止溢栈，我们可以限制迭代的层数，超过指定的层数，就会报错。
编码(encode)：
> lua_value = {true, {foo="bar"}}
> json_text = cjson.encode(lua_value) => Returns: '[true, {"foo":"bar"}]'
cjson.encode会把一个Lua value或table转为一个UTF-8的JSON字符串。支持的Lua类型有boolean、空lightuserdate、nil、number（最多14位有效数字）、string和table，不支持的Lua类型有function、非空lightuserdata、thread和userdata。在UTF-8字符串中要转义(加/)的字符有ASCII 0~31(控制字符)、ASCII 34(")、ASCII 47(\)、ASCII 92(/)、ASCII 127(Delete)。如果Lua table中的key全是正整数，会转为JSON array([ ])，否则转为JSON object({ })，Lua JSON只支持key为number和string，其他类型会报错，它不会使用元方法，只会使用rawget遍历Lua array，使用next遍历Lua object，Lua array和Lua object其实都是Lua table。
> setting = cjson.encode_invalid_numbers([setting]) #setting为true、null或false，默认为false
当编码一个Lua浮点数时可能会产生一个JSON不支持的数字(infinity或NaN)，true表示允许编码这些非法数字，可能产生一个不标准的JSON表示，null表示把所有的非法数字都转为JSON null值，false表示遇到非法数字报错。
> keep = cjson.encode_keep_buffer([keep]) #keep为true或false，默认为true
true表示JSON encoding buffer会一直被重用，直到JSON模块被垃圾回收为止，false表示每次调用cjson.encode都会创建和释放JSON encoding buffer。
> depth = cjson.encode_max_depth([depth]) #depth为正整数，默认为1000层
与cjson.decode_max_depth类似。
> precision = cjson.encode_number_precision([precision]) #precision为1至14，默认为14
用来设置JSON中数字的精度（有效位数）。
> convert, ratio, safe = cjson.encode_parse_array([convert[, ratio[, safe]]]) #convert为true或false，默认为false，ratio为正整数，默认为2，safe为正整数，默认为10
与编码稀疏的Lua array有关，很复杂，忽略之。
类似资料：