Struct DomRef 

pub struct DomRef<'t, 'src: 't> { /* private fields */ }

A lightweight cursor into a Dom, pointing at a single entry by index.

't is the lifetime of the borrow of the tape; 'src is the lifetime of the source JSON bytes ('src: 't). Both lifetimes collapse to the same 'a in the common case where you borrow the tape and the source in the same scope.

Created via Dom::root. Implements crate::JsonRef.

Implementations

impl<'t, 'src: 't> DomRef<'t, 'src>

pub fn object_iter(self) -> Option<DomObjectIter<'t, 'src>>

Returns an iterator over the key-value pairs if this value is a JSON object, or None otherwise.

Example

use asmjson::{parse_to_dom, JsonRef};

let tape = parse_to_dom(r#"{"a":1,"b":2}"#, None).unwrap();
let root = tape.root().unwrap();
for (key, val) in root.object_iter().unwrap() {
    println!("{key}: {}", val.as_number_str().unwrap());
}

pub fn array_iter(self) -> Option<DomArrayIter<'t, 'src>>

Returns an iterator over the elements if this value is a JSON array, or None otherwise.

Example

use asmjson::{parse_to_dom, JsonRef};

let tape = parse_to_dom(r#"[1,2,3]"#, None).unwrap();
let root = tape.root().unwrap();
for elem in root.array_iter().unwrap() {
    println!("{}", elem.as_number_str().unwrap());
}

Trait Implementations

impl<'t, 'src: 't> Clone for DomRef<'t, 'src>

fn clone(&self) -> DomRef<'t, 'src>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'t, 'src: 't> JsonRef<'t> for DomRef<'t, 'src>

type Item = DomRef<'t, 'src>

The concrete node type returned by get and index_at.

fn is_array(self) -> bool

Returns true if this value is a JSON array.

fn is_object(self) -> bool

Returns true if this value is a JSON object.

fn as_null(self) -> Option<()>

Returns Some(()) if this value is null, otherwise None.

fn as_bool(self) -> Option<bool>

Returns the boolean if this value is a boolean, otherwise None.

fn as_number_str(self) -> Option<&'t str>

Returns the raw number token if this value is a number, otherwise None.

fn as_str(self) -> Option<&'t str>

Returns the string content if this value is a JSON string, otherwise None.

fn get(self, key: &str) -> Option<Self>

Look up an object member by key.

fn index_at(self, idx: usize) -> Option<Self>

Index into an array by zero-based position.

fn len(self) -> Option<usize>

Returns the number of elements (array) or key-value pairs (object).

fn is_null(self) -> bool

Returns true if this value is JSON null.

fn is_bool(self) -> bool

Returns true if this value is a JSON boolean.

fn is_number(self) -> bool

Returns true if this value is a JSON number.

fn is_string(self) -> bool

Returns true if this value is a JSON string.

fn as_i64(self) -> Option<i64>

Parse the number as i64.

fn as_u64(self) -> Option<u64>

Parse the number as u64.

fn as_f64(self) -> Option<f64>

Parse the number as f64.

impl<'t, 'src: 't> Copy for DomRef<'t, 'src>