Struct serde_yaml::Mapping

pub struct Mapping { /* fields omitted */ }

A YAML mapping in which the keys and values are both serde_yaml::Value.

Methods

impl Mapping

pub fn new() -> Self

Creates an empty YAML map.

pub fn with_capacity(capacity: usize) -> Self

Creates an empty YAML map with the given initial capacity.

pub fn reserve(&mut self, additional: usize)

Reserves capacity for at least additional more elements to be inserted into the map. The map may reserve more space to avoid frequent allocations.

Panics

Panics if the new allocation size overflows usize.

pub fn shrink_to_fit(&mut self)

Shrinks the capacity of the map as much as possible. It will drop down as much as possible while maintaining the internal rules and possibly leaving some space in accordance with the resize policy.

pub fn insert(&mut self, k: Value, v: Value) -> Option<Value>

Inserts a key-value pair into the map. If the key already existed, the old value is returned.

pub fn contains_key(&self, k: &Value) -> bool

Checks if the map contains the given key.

pub fn get(&self, k: &Value) -> Option<&Value>

Returns the value corresponding to the key in the map.

pub fn get_mut(&mut self, k: &Value) -> Option<&mut Value>

Returns the mutable reference corresponding to the key in the map.

pub fn remove(&mut self, k: &Value) -> Option<Value>

Removes and returns the value corresponding to the key from the map.

pub fn capacity(&self) -> usize

Returns the maximum number of key-value pairs the map can hold without reallocating.

pub fn len(&self) -> usize

Returns the number of key-value pairs in the map.

pub fn is_empty(&self) -> bool

Returns whether the map is currently empty.

pub fn clear(&mut self)

Clears the map of all key-value pairs.

pub fn iter(&self) -> Iter

Returns a double-ended iterator visiting all key-value pairs in order of insertion. Iterator element type is (&'a Value, &'a Value).

pub fn iter_mut(&mut self) -> IterMut

Returns a double-ended iterator visiting all key-value pairs in order of insertion. Iterator element type is (&'a Value, &'a mut ValuE).

Trait Implementations

impl PartialEq<Mapping> for Mapping

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Default for Mapping

fn default() -> Mapping

Returns the "default value" for a type.

impl Clone for Mapping

fn clone(&self) -> Mapping

Returns a copy of the value.

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

Performs copy-assignment from source.

impl From<Mapping> for Value

fn from(f: Mapping) -> Self

Convert map (with string keys) to Value

Examples

use serde_yaml::{Mapping, Value};

let mut m = Mapping::new();
m.insert("Lorem".into(), "ipsum".into());
let x: Value = m.into();

impl<'a> IntoIterator for &'a Mapping

type Item = (&'a Value, &'a Value)

The type of the elements being iterated over.

type IntoIter = Iter<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a> IntoIterator for &'a mut Mapping

type Item = (&'a Value, &'a mut Value)

The type of the elements being iterated over.

type IntoIter = IterMut<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for Mapping

type Item = (Value, Value)

The type of the elements being iterated over.

type IntoIter = IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl Eq for Mapping

impl Extend<(Value, Value)> for Mapping

fn extend<I: IntoIterator<Item = (Value, Value)>>(&mut self, iter: I)

Extends a collection with the contents of an iterator.

impl PartialOrd<Mapping> for Mapping

fn partial_cmp(&self, other: &Mapping) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Mapping) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Mapping) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Mapping) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Mapping) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Debug for Mapping

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

Formats the value using the given formatter.

impl<'a> Index<&'a Value> for Mapping

type Output = Value

The returned type after indexing.

fn index(&self, index: &'a Value) -> &Value

Performs the indexing (container[index]) operation.

impl<'a> IndexMut<&'a Value> for Mapping

fn index_mut(&mut self, index: &'a Value) -> &mut Value

Performs the mutable indexing (container[index]) operation.

impl Hash for Mapping

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl FromIterator<(Value, Value)> for Mapping

fn from_iter<I: IntoIterator<Item = (Value, Value)>>(iter: I) -> Self

Creates a value from an iterator.

impl Serialize for Mapping

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl<'de> Deserialize<'de> for Mapping

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.