Struct jsonp::BackingJson

pub struct BackingJson<'a> { /* fields omitted */ }

Convenience wrapper around the library core functions for raw Json, removing some of the generic noise from function signatures.

Implementations

impl<'a> BackingJson<'a>

pub fn new(borrow: &'a RawJson) -> Self

Instantiate a wrapper around the given borrowed raw Json.

pub fn with(borrow: &'a RawJson, p: Pointer) -> Self

Instantiate a wrapper around the given borrowed raw Json and pointer.

pub fn dotted<'de, T>(&self, pointer: &str) -> Result<T, Error> where
    T: Deserialize<'de>,
    'a: 'de, 

See the documentation of Pointer::dotted.

Example

use {jsonp::{BackingJson, Segment}, serde_json::from_str};

let json = from_str(r#"{"outer": {"array": [0, "one", true]}}"#).unwrap();
let one: &str = BackingJson::new(json).dotted("outer.array.1").unwrap();

assert!(one == "one");

pub fn pattern<'de, T>(&self, pointer: &str, pattern: &str) -> Result<T, Error> where
    T: Deserialize<'de>,
    'a: 'de, 

See the documentation of Pointer::with_pattern.

Example

use {jsonp::{BackingJson, Segment}, serde_json::from_str};

let json = from_str(r#"{"outer": {"array": [0, "one", true]}}"#).unwrap();
let is_true: bool = BackingJson::new(json).pattern("outer array 2", " ").unwrap();

assert!(is_true);

pub fn pointer<'de, 'p, I, T>(&self, pointers: I) -> Result<T, Error> where
    I: IntoIterator<Item = Segment<'p>>,
    T: Deserialize<'de>,
    'a: 'de, 

See the documentation for Pointer::with_segments.

Example

use {jsonp::{BackingJson, Segment}, serde_json::from_str};

let json = from_str(r#"{"outer": {"array": [0, 1, 2, 3]}}"#).unwrap();
let segments = &["outer", "array"];
let array: Vec<i8> = BackingJson::new(json)
    .pointer(segments.into_iter().copied().map(Segment::lazy))
    .unwrap();

assert_eq!(&array, &[0, 1, 2, 3]);

Trait Implementations

impl<'a> Clone for BackingJson<'a>

fn clone(&self) -> BackingJson<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for BackingJson<'a>

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

Formats the value using the given formatter.

impl<'a> From<&'a RawValue> for BackingJson<'a>

fn from(backing: &'a RawJson) -> Self

Performs the conversion.