Enum Value

A value of a valid JSON datatype.

This is what is returned from the parser, and what can be serialized back into JSON data. You may want to extract your parsed data from this enum to a more specialized data structure, to make working with it more ergonomic.

scoped enum Value
{
    Array(List[Value]),
    Boolean(Boolean),
    Null,
    Number(Double),
    Object(Hash[String, Value]),
    String(String)
}

Returns the internal Boolean contained within self.

• ValueError if self is not of type Value.Boolean.

Returns the internal Double contained within self.

• ValueError if self is not a Value.Number.

Returns the internal Hash contained within self.

• ValueError if self is not of type Value.Object.

Returns the internal Double contained within self, casted to an Integer.

• ValueError if self is not of type Value.Number.
• ValueError if self is not an integer / has a fractional part.

Returns the internal List contained within self.

• ValueError if self is not of type Value.Array.

Returns the internal String contained within self.

• ValueError if self is not of type Value.String.

Returns the Value at index in self.

• ValueError if self is not of type Value.Array.
• IndexError if index is out of range.

Calls fn for each Value in self.

• ValueError if self is not of type Value.Array or Value.Object.

Calls fn for each index/Value pair in self.

• ValueError if self is not of type Value.Array.

Calls fn for each key/Value pair in self.

• ValueError if self is not of type Value.Object.

Returns the Value corresponding to key in self.

• ValueError if self is not of type Value.Object.
• IndexError if key is not in self.

Converts self to a String containing JSON data.

If format is true, the output JSON will be auto-formatted with consistent spacing and indentation. If you need your JSON to be human-readable, this may be desirable; however, if working with a large amount of data, you may want to keep it disabled to keep the size of the output JSON small.

If non_finite is true (the default), non-finite numbers (Infinity, -Infinity, and NaN) will be serialized.

• ValueError if a non-finite number is encountered, but non_finite is false.

Utility function to write serialized JSON data to a file.

format and non_finite function identically to how they do in Value.encode.