1
0
Fork 0
A lightweight JSON library for Lua
 
 
Go to file
rxi 9fbfcde195 Improved error messages when encoding invalid table 2015-08-30 19:17:58 +01:00
bench Fixed indentation in benchmark util script 2015-08-14 20:00:48 +01:00
test Updated tests for encoding sparse/mixed key-type tables 2015-08-30 19:11:19 +01:00
LICENSE Initial commit 2015-08-11 21:08:33 +01:00
README.md Added checking for sparseness and mixed key types when encoding array 2015-08-30 19:08:50 +01:00
json.lua Improved error messages when encoding invalid table 2015-08-30 19:17:58 +01:00

README.md

json.lua

A lightweight JSON library for Lua

Features

  • Implemented in pure Lua: works with 5.1, 5.2, 5.3 and JIT
  • Fast: generally outperforms other pure Lua JSON implementations (benchmark scripts)
  • Tiny: around 290sloc, 9kb
  • Proper error messages, eg: expected '}' or ',' at line 203 col 30

Usage

The json.lua file should be dropped into an existing project and required by it:

json = require "json"

The library provides the following functions:

json.encode(value)

Returns a string representing value encoded in JSON.

json.encode({ 1, 2, 3, { x = 10 } }) -- Returns '[1,2,3,{"x":10}]'

json.decode(str)

Returns a value representing the decoded JSON string.

json.decode('[1,2,3,{"x":10}]') -- Returns { 1, 2, 3, { x = 10 } }

Notes

  • Tables with the key 1 set are treated as arrays when encoding
  • null values contained within an array or object are converted to nil and are therefore lost upon decoding
  • Pretty encoding is not supported, json.encode() only encodes to a compact format

License

This library is free software; you can redistribute it and/or modify it under the terms of the MIT license. See LICENSE for details.