Struct Context 

pub struct Context<'a> { /* private fields */ }

A cheap, clonable handle threaded through every load impl.

Loaders use the as_* accessors to peek at the underlying save::Value kind (e.g. Context::as_object, Context::as_array, Context::as_str) and Context::load to recursively deserialize a nested value into a concrete type.

Implementations

impl<'a> Context<'a>

pub fn load<T>(&self) -> Result<T>

where T: Loadable<'a>,

Recursively deserialize the underlying value into a T.

Equivalent to calling T::load(self.clone()). Use this from inner loaders that want to delegate to another Loadable.

pub fn as_object(&self) -> Option<Object<'a>>

Returns Some(Object) if the value is a versioned object, else None.

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

Returns Some(s) if the value is a string, else None.

pub fn as_array(&self) -> Option<Array<'a>>

Returns Some(Array) if the value is an array, else None.

pub fn as_number(&self) -> Option<Number>

Returns Some(Number) if the value is numeric, else None.

Use the conversion methods on Number (e.g. as_u32, as_i64) to narrow to the target Rust type; out-of-range conversions return None and should be surfaced as error::Kind::NumberOutOfRange.

pub fn as_bool(&self) -> Option<bool>

Returns Some(b) if the value is a boolean, else None.

pub fn is_null(&self) -> bool

Returns true if the value is null.

Used by Loadable impls for Option<T> to detect the absent variant.

Trait Implementations

impl<'a> Clone for Context<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.