[−][src]Enum jsondata::Json

pub enum Json {
    Null,
    Bool(bool),
    Integer(Integral),
    Float(Floating),
    String(String),
    Array(Vec<Json>),
    Object(Vec<Property>),
    // some variants omitted
}

Json type implements JavaScript Object Notation as per specification RFC-8259.

Numbers are implemented with deferred conversion, using Integral and Floating types.
Arrays are implemented as vector of Json values Vec<Json>.
Objects are implemented as vector of properties, Vec<Property>, where each property is a tuple of (key, value). Here key is String type and value is Json type.

Variants

NullBool(bool)Integer(Integral)Float(Floating)String(String)Array(Vec<Json>)Object(Vec<Property>)

Methods

`impl Json`
[src]

Implementation provides methods to construct and validate Json values.

`pub fn new<T>(value: T) -> Json where Self: From<T>,`
[src]

Construct Json from bool, i128, f64, String, str, Vec.

Array can be composed as:

use jsondata::Json;

let mut js = Json::new::<Vec<Json>>(Vec::new());
js.append("", Json::new(10));
js.append("", Json::new("hello world".to_string()));

It is also possbile to construct the vector of Json outside the append() method, and finally use Json::new() to construct the array.

Object can be composed as:

use jsondata::{Json, Property};

let mut js = Json::new::<Vec<Property>>(Vec::new());
js.set("/key1", Json::new(10));
js.set("/key2", Json::new(true));

It is also possbile to construct the vector of properties outside the set() method, and finally use Json::new() to construct the object.

`pub fn validate(&mut self) -> Result<(), String>`
[src]

Validate parts of JSON text that are not yet parsed. Typically, when used in database context, JSON documents are validated once but parsed multiple times.

`pub fn compute(&mut self) -> Result<(), String>`
[src]

Compute parses unparsed text and convert them into numbers. When a JSON document is parsed once but operated on multiple times it is better to call compute for better performance.

use jsondata::Json;

let text = r#"[null,true,false,10,"true"]"#;
let mut json: Json = text.parse().unwrap();
json.compute();

// perform lookup and arithmetic operations on parsed document.

`impl Json`
[src]

Implementation provides CRUD access into Json document using Json Pointer. For all methods,

Path must be valid JSON Pointer.
Path fragment must be valid key if parent container is an object.
Path fragment must be a number index if parent container is an array.

`pub fn get(&self, path: &str) -> Result<Json, String>`
[src]

Get a json field, within the document, locatable by path.

`pub fn set(&mut self, path: &str, value: Json) -> Result<(), String>`
[src]

Set a json field, within the document, locatable by path.

`pub fn delete(&mut self, path: &str) -> Result<(), String>`
[src]

Delete a json field, within the document, locatable by path.

`pub fn append(&mut self, path: &str, value: Json) -> Result<(), String>`
[src]

Append a string or array to a json field within the document that is either a string or array.

`pub fn range<R>(&self, range: R) -> Json where R: RangeBounds<isize>,`
[src]

Range operation on Json array,

Range [start..end].
RangeFrom [start..].
RangeFull [..].
RangeInclusive [start..=end].
RangeTo [..end].
RangeToInclusive [..=end].

If range is called on non array Json, returns a Json Error.

`impl Json`
[src]

Implementation clones underlying type for each Json variant. The return value is always an Option because JSON follows a schemaless data representation.