JSON API documentation

Version: alpha

FUNCTION
json.decode()	decode JSON from a string to a lua-table
json.encode()	encode a lua table to a JSON string

CONSTANT
json.null	null

Functions

json.decode()

json.decode(json)

Decode a string of JSON data into a Lua table. A Lua error is raised for syntax errors.

PARAMETERS

json string json data

RETURNS

data table decoded json

EXAMPLES

Converting a string containing JSON data into a Lua table:

function init(self)
    local jsonstring = '{"persons":[{"name":"John Doe"},{"name":"Darth Vader"}]}'
    local data = json.decode(jsonstring)
    pprint(data)
end

Results in the following printout:

{
  persons = {
    1 = {
      name = John Doe,
    }
    2 = {
      name = Darth Vader,
    }
  }
}

json.encode()

json.encode(tbl)

Encode a lua table to a JSON string. A Lua error is raised for syntax errors.

PARAMETERS

tbl table lua table to encode

RETURNS

json string encoded json

EXAMPLES

Convert a lua table to a JSON string:

function init(self)
     local tbl = {
          persons = {
               { name = "John Doe"},
               { name = "Darth Vader"}
          }
     }
     local jsonstring = json.encode(tbl)
     pprint(jsonstring)
end

Results in the following printout:

{"persons":[{"name":"John Doe"},{"name":"Darth Vader"}]}

Constants

json.null

Represents the null primitive from a json file