erlang-rison

A Rison encoder/decoder written in Erlang.

Howto get it

Download a tarball, or git clone git://github.com/tim/erlang-rison.git.

Howto use it

To convert Rison-formatted strings into Erlang terms, use rison:load/1. To do the opposite, use rison:dump/1. For example:

1> rison:load("!t").
{ok, true}

2> rison:load("!(1,2,3)").
{ok,{array,[1,2,3]}}

3> rison:load("123.456e789").
{ok,{number,123,'456',789}}

4> rison:load("abc def").
{error,invalid_input}

5> rison:dump({array,[1,2,3]}).
{ok,"!(1,2,3)"}

6> rison:dump({object,[{a,0}]}).
{ok,"(a:0)"}

7> rison:dump({}).
{error,invalid_input}

N.B.

Things that might be non-obvious, or counter-intuitive:

• the null value is converted to/from undefined (the atom)
• numbers are converted to/from: integer() | {number, Int::integer(), Frac::atom(), Exp::exp()},
  where exp() = undefined | integer()
• arrays are converted to/from: {array, Elements::list()}
• objects are converted to/from: {object, Members::list()}
• strings can contain unicode characters, but id values cannot
• values returned from rison:dump/1 are not URI-encoded
• values passed to rison:load/1 should not be URI-encoded

13th May 2008