Struct ValueMap

pub struct ValueMap(/* private fields */);

A mapping from tag names to Values.

Implementations

impl ValueMap

pub fn new() -> Self

pub fn get<'v, E>(&'v self) -> Option<Result<E, Error>>

where E: Element + TryFrom<&'v Value, Error = Error>,

Extract a child element of a specific type.

Returns

• None if the element doesn’t exist
• Some(Ok(_)) if the element exists and was successfully extracted
• Some(Err(_)) if the element exists and extraction failed

pub fn get_optional<'v, E>(&'v self) -> Option<Option<Result<E, Error>>>

where E: Element + TryFrom<&'v Value, Error = Error>,

Extract a non-empty child element of a specific type.

Returns

• None if the element doesn’t exist
• Some(None) if the element exists and is empty
• Some(Some(Ok(_))) if the element exists, is not empty and was successfully extracted
• Some(Some(Err(_))) if the element exists, is not empty and extraction failed

pub fn insert<E: Element>(&mut self, value: Value)

Insert a child value into the map.

Trait Implementations

impl AsMut<IndexMap<ElementName<ByteString>, Value>> for ValueMap

fn as_mut(&mut self) -> &mut IndexMap<ElementName<ByteString>, Value>

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<IndexMap<ElementName<ByteString>, Value>> for ValueMap

fn as_ref(&self) -> &IndexMap<ElementName<ByteString>, Value>

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for ValueMap

fn clone(&self) -> ValueMap

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ValueMap

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

Formats the value using the given formatter.

impl Default for ValueMap

fn default() -> ValueMap

Returns the “default value” for a type.

impl From<IndexMap<ElementName<ByteString>, Value>> for ValueMap

fn from(map: IndexMap<ElementName<ByteString>, Value>) -> Self

Converts to this type from the input type.

impl PartialEq for ValueMap

fn eq(&self, other: &ValueMap) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ValueMap