Parse a JSON file into memory.

Example

val: Value = parse("{}");

A DOM parser parses an entire file into memory at once. This is often simpler, but if your files are very large, you may need to use the SAX parser, see watt.json.sax.

Code Map

//! Parse a JSON file into memory.
module watt.json.dom;


//! Identifies the JSON type of a Value.
enum DomType
{
	//! A JSON value of null.
	Null,
	//! A JSON value of true or false.
	Boolean,
	//! A JSON value of a number with a decimal portion.
	Double,
	//! A JSON value of a signed integer.
	Long,
	//! A JSON value of an unsigned integer.
	Ulong,
	//! A JSON string.
	String,
	//! A JSON object, everything between {}.
	Object,
	//! A JSON array, everything between [].
	Array,
}

//! Thrown upon a parsing error.
class DOMException : JSONException
{
public:
	this(msg: string, location: string) { }
}

//! A JSON value.
struct Value
{
public:
	union Store
	{
	public:
		boolean: bool;
		str: immutable(char)[];
		integer: i64;
		unsigned: u64;
		floating: f64;
	}


public:
	fn type() DomType { }
	//! Is this Value a JSON null type?
	fn isNull() bool { }
	//! Set the type to null.
	fn setNull() { }
	//! Get this as a boolean value.
	fn boolean() bool { }
	//! Set this Value as a DomType.Boolean, and give it the value b.
	fn boolean(b: bool) { }
	//! Get this as a string value.
	fn str() string { }
	//! Set this Value as a DomType.String, and give it the value s.
	fn str(s: const(char)[]) { }
	//! Get this as an integer value.
	fn integer() i64 { }
	//! Set this Value as a DomType.Long, and give it the value l.
	fn integer(l: i64) { }
	//! Get this as an unsigned integer value.
	fn unsigned() u64 { }
	//! Set this Value as a DomType.Ulong, and give it the value l.
	fn unsigned(l: u64) { }
	//! Get this as a floating point value.
	fn floating() f64 { }
	//! Set this Value as a DomType.Double, and give it the value d.
	fn floating(d: f64) { }
	//! Get this as an array of Value.
	fn array() Value[] { }
	//! Set this Value as a DomType.Array, and give it the value array.
	fn array(array: Value[]) { }
	//! Add val to this Value's array.
	fn arrayAdd(val: Value) { }
	//! Set type as DomType.Array.
	fn setArray() { }
	//! Retrieve a key from this Value.
	fn lookupObjectKey(s: string) Value { }
	//! Does this object have a key s?
	fn hasObjectKey(s: string) bool { }
	//! Set this Value as an object, and set a key.
	fn setObjectKey(k: string, v: Value) { }
	//! Set type as DomType.Object.
	fn setObject() { }
	//! Retrieve all the keys associated with this Value.
	fn keys() string[] { }
	//! Retrieve all the values associated with this Value.
	fn values() Value[] { }
}

//! Parse a JSON string into a Value.
fn parse(s: string) Value { }