Struct Map 

pub struct Map { /* private fields */ }

Keys are shared: a decoded document allocates each distinct key once, however many maps have it.

Implementations

impl Map

pub fn new() -> Self

An empty map.

pub fn with_capacity(n: usize) -> Self

An empty map with room for n entries.

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

The value of key.

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

The value of key, to change.

pub fn value_at(&self, i: usize) -> Option<&Value>

The value of the i-th entry.

pub fn index_of(&self, key: &str) -> Option<usize>

The position of key among the entries.

pub fn insert(&mut self, key: impl Into<String>, value: Value) -> Option<Value>

Sets key, in place if it’s there, else at the end; returns the old value.

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

Takes key’s entry out: its value, the others keeping their order.

pub fn len(&self) -> usize

How many entries.

pub fn is_empty(&self) -> bool

Whether it has no entries.

pub fn iter(&self) -> impl ExactSizeIterator<Item = (&str, &Value)>

The entries, in order.

pub fn keys(&self) -> impl ExactSizeIterator<Item = &str> + Clone

The keys, in order.

pub fn values(&self) -> impl ExactSizeIterator<Item = &Value>

The values, in order.

pub fn retain(&mut self, keep: impl FnMut(&str, &Value) -> bool)

Keeps the entries keep says to, in one pass; the index made again when it’s next needed.

Trait Implementations

impl Clone for Map

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Map

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

Formats the value using the given formatter.

impl Default for Map

fn default() -> Self

Returns the “default value” for a type.

impl From<Map> for Value

fn from(m: Map) -> Self

Converts to this type from the input type.

impl<K: Into<String>> FromIterator<(K, Value)> for Map

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

Creates a value from an iterator.

impl IntoIterator for Map

type Item = (String, Value)

The type of the elements being iterated over.

type IntoIter = Map<IntoIter<(Arc<str>, Value)>, fn((Arc<str>, Value)) -> (String, Value)>

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 Map

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

The type of the elements being iterated over.

type IntoIter = Map<Iter<'a, (Arc<str>, Value)>, fn(&'a (Arc<str>, Value)) -> (&'a str, &'a Value)>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for Map

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

Equality operator ==.

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

Inequality operator !=.