Transferred cjson module documentation.

This commit is contained in:
Johny Mattsson 2016-01-06 11:51:48 +11:00
parent d3331c2057
commit e5de056756
2 changed files with 51 additions and 0 deletions

50
docs/en/modules/cjson.md Normal file
View File

@ -0,0 +1,50 @@
# cjson Module
The JSON support module. Allows encoding and decoding to/from JSON.
Please note that nested tables can require a lot of memory to encode. To catch out-of-memory errors, use `pcall()`.
## cjson.encode()
Encode a Lua table to a JSON string.
####Syntax
`cjson.encode(table)`
####Parameters
- `table`: data to encode
While it also is possible to encode plain strings and numbers rather than a table, it is not particularly useful to do so.
####Returns
string:in json format
####Example
```lua
ok, json = pcall(cjson.encode, {key="value"})
if ok then
print(json)
else
print("failed to encode!")
end
```
___
## cjson.decode()
Decode a JSON string to a Lua table.
####Syntax
`cjson.decode(str)`
####Parameters
- `str`: The JSON string to decode
####Returns
table:Lua representation of the JSON data
####Example
```lua
t = cjson.decode('{"key":"value"}')
for k,v in pairs(t) do print(k,v) end
```
___

View File

@ -31,6 +31,7 @@ pages:
- Modules: - Modules:
- 'adc': 'en/modules/adc.md' - 'adc': 'en/modules/adc.md'
- 'bit': 'en/modules/bit.md' - 'bit': 'en/modules/bit.md'
- 'cjson': 'en/modules/cjson.md'
- 'crypto': 'en/modules/crypto.md' - 'crypto': 'en/modules/crypto.md'
- 'gpio': 'en/modules/gpio.md' - 'gpio': 'en/modules/gpio.md'
- 'node': 'en/modules/node.md' - 'node': 'en/modules/node.md'