Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Artifact ID:	b6e655914d6bf281711323fb1fc7495cdcb9b029
Page Name:	dkjson
Date:	2013-09-28 19:30:35
Original User:	dhkolf
Parent:	df3403756f40cfa476388adb35f0b96ba334da91

JSON Module for Lua

Introduction

This is a JSON module written in Lua. It supports UTF-8.

JSON (JavaScript Object Notation) is a format for serializing data based on the syntax for JavaScript data structures. It is an ideal format for transmitting data between different applications and commonly used for dynamic web pages. It can also be used to save Lua data structures, but you should be aware that not every Lua table can be represented by the JSON standard. For example tables that contain both string keys and an array part cannot be exactly represented by JSON. You can solve this by putting your array data in an explicit subtable.

dkjson is written in Lua without any dependencies, but when LPeg is available dkjson uses it to speed up decoding.

Download

• dkjson.lua

The full documentation including the license is available here in the wiki or as Markdown text in the source file.

dkjson is free software released under the same conditions as the Lua interpreter. Please remember to mention external code you are using in your software.

Examples

Encoding

local json = require ("dkjson")

local tbl = {
  animals = { "dog", "cat", "aardvark" },
  instruments = { "violin", "trombone", "theremin" },
  bugs = json.null,
  trees = nil
}

local str = json.encode (tbl, { indent = true })

print (str)

Output

{
  "bugs":null,
  "instruments":["violin","trombone","theremin"],
  "animals":["dog","cat","aardvark"]
}

Decoding

local json = require ("dkjson")

local str = [[
{
  "numbers": [ 2, 3, -20.23e+2, -4 ],
  "currency": "\u20AC"
}
]]

local obj, pos, err = json.decode (str, 1, nil)
if err then
  print ("Error:", err)
else
  print ("currency", obj.currency)
  for i = 1,#obj.numbers do
    print (i, obj.numbers[i])
  end
end

Output

currency	€
1	2
2	3
3	-2023
4	-4

Versions

Version 2.4 (2013-09-28)

• Download dkjson.lua version 2.4

Changes since version 2.3:

• Fixed encoding and decoding of numbers in different numeric locales.
• Prevent using version 0.11 of LPeg (causes segmentation faults on some systems).

Version 1.3 (2013-09-28)

• Download dkjson.lua version 1.3

Changes since version 1.2:

• Fixed encoding and decoding of numbers in different numeric locales.

Version 2.3 (2013-04-14)

• Download dkjson.lua version 2.3

Changes since version 2.2:

• Corrected the range of escaped characters. Among other characters U+2029 was missing, which would cause trouble when parsed by a JavaScript interpreter.
• Added options to register the module table in a global variable. This is useful in environments where functions similar to require are not available.

Version 1.2 (2013-04-14)

• Download dkjson.lua version 1.2

Changes since version 1.1:

• Corrected the range of escaped characters. Among other characters U+2029 was missing, which would cause trouble when parsed by a JavaScript interpreter.
• Locations for error messages were off by one in the first line.

Version 2.2 (2012-04-28)

• Download dkjson.lua version 2.2

Changes since version 2.1:

• __jsontype is only used for empty tables.
• It is possible to decode tables without assigning metatables.
• Locations for error messages were off by one in the first line.
• There is no LPeg version of json.quotestring anymore.

Version 2.1 (2011-07-08)

• Download dkjson.lua version 2.1

Changes since version 2.0:

• Changed the documentation to Markdown format.
• LPeg is now parsing only a single value at a time to avoid running out of Lua stack for big arrays and objects.
• Read __tojson, __jsontype and __jsonorder even from blocked metatables through the debug module.
• Fixed decoding single numbers (only affected the non-LPeg mode).
• Corrected the range of escaped Unicode control characters.

Version 1.1 (2011-07-08)

• Download dkjson.lua version 1.1

Changes since version 1.0:

• The values NaN/+Inf/-Inf are recognised and encoded as "null" like in the original JavaScript implementation.
• Read __tojson even from blocked metatables through the debug module.
• Fixed decoding single numbers.
• Corrected the range of escaped Unicode control characters.

Version 2.0 (2011-05-30)

• Download dkjson.lua version 2.0

Changes since version 1.0:

• Optional LPeg support.
• Invalid input data for encoding raises errors instead of returning nil and the error message. (Invalid data for encoding is usually a programming error. Raising an error removes the work of explicitly checking the result).
• The metatable field __jsontype can control whether a Lua table is encoded as a JSON array or object. (Mainly useful for empty tables).
• When decoding, two metatables are created. One is used to mark the arrays while the other one is used for the objects. (The metatables are created once for each decoding operation to make sandboxing possible. However, you can specify your own metatables as arguments).
• There are no spaces added any longer when encoding.
• It is possible to explicitly sort keys for encoding by providing an array with key names to the option "keyorder" or the metatable field __jsonorder.
• The values NaN/+Inf/-Inf are recognised and encoded as "null" like in the original JavaScript implementation.

Version 1.0 (2010-08-28)

Initial version.

• Download dkjson.lua version 1.0