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有关，很复杂，忽略之。