Crate json [] [src]

JSON in Rust

Parse and serialize JSON with ease.

#[macro_use]
extern crate json;
use json::JsonValue;

fn main() {
    // stringify
    let data = object!{
        "a" => "bar",
        "b" => array![1,false,"foo"]
    };
    let string = json::stringify_ref(&data);

    // parse
    let parsed_data = json::parse(&string).unwrap();

    assert_eq!(data, parsed_data);
    assert_eq!(parsed_data.get("a").unwrap().as_string().unwrap(), "bar");
    assert!(parsed_data.get("b").unwrap().at(0).unwrap().is_number());
}

Serialize with json::stringify(value)

Primitives:

// str slices
assert_eq!(json::stringify("foobar"), "\"foobar\"");

// Owned strings
assert_eq!(json::stringify("foobar".to_string()), "\"foobar\"");

// Any number types
assert_eq!(json::stringify(42), "42");

// Booleans
assert_eq!(json::stringify(true), "true");
assert_eq!(json::stringify(false), "false");

Explicit null type json::Null:

assert_eq!(json::stringify(json::Null), "null");

Optional types:

let value: Option<String> = Some("foo".to_string());
assert_eq!(json::stringify(value), "\"foo\"");

let no_value: Option<String> = None;
assert_eq!(json::stringify(no_value), "null");

Vector:

let data = vec![1,2,3];
assert_eq!(json::stringify(data), "[1,2,3]");

Vector with optional values:

let data = vec![Some(1), None, Some(2), None, Some(3)];
assert_eq!(json::stringify(data), "[1,null,2,null,3]");

Pushing to arrays:

let mut data = json::JsonValue::new_array();

data.push(10);
data.push("foo");
data.push(false);

assert_eq!(json::stringify(data), "[10,\"foo\",false]");

array! macro:

let data = array!["foo", "bar", 100, true, json::Null];
assert_eq!(json::stringify(data), "[\"foo\",\"bar\",100,true,null]");

object! macro:

let data = object!{
    "name"    => "John Doe",
    "age"     => 30,
    "canJSON" => true
};
assert_eq!(
    json::stringify(data),
    // Because object is internally using a BTreeMap,
    // the key order is alphabetical
    "{\"age\":30,\"canJSON\":true,\"name\":\"John Doe\"}"
);

Reexports

pub use value::JsonValue::Null;

Macros

array!
object!

Enums

JsonError
JsonValue

Functions

parse
stringify
stringify_ref

Type Definitions

Array
JsonResult
Object