Struct PointerTree

pub struct PointerTree { /* private fields */ }

PointerTree is designed for get_many and get_many_unchecked.

It is recommended to use get_many when you need to get multiple values from json. Instead of using get multiple times.

Examples

let json = r#"
{"u": 123, "a": {"b" : {"c": [null, "found"]}}}"#;

// build a pointer tree, representing multiple json path
let mut tree = PointerTree::new();

tree.add_path(&["u"]);
tree.add_path(&pointer!["a", "b", "c", 1]);

let nodes = unsafe { sonic_rs::get_many_unchecked(json, &tree) };

// the node order is as the order of `add_path`
for val in nodes.unwrap() {
    println!("{}", val.as_raw_str());
    // 123
    // "found"
}

Implementations

impl PointerTree

pub fn new() -> Self

Creat a empty tree. If get_many from empty tree, it will return the whole json.

pub fn add_path<Path: IntoIterator>(&mut self, path: Path)

where Path::Item: Index,

we build tree and return value according by the order of path. Allow the repeated path.

pub fn size(&self) -> usize

the count of nodes

Trait Implementations

impl Debug for PointerTree

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PointerTree

fn default() -> PointerTree

Returns the “default value” for a type.