Struct serde_json_borrow::ObjectAsVec

pub struct ObjectAsVec<'ctx>(pub Vec<(&'ctx str, Value<'ctx>)>);

For performance reasons we use a Vec instead of a Hashmap.

This comes with a tradeoff of slower key accesses as we need to iterate and compare.

The ObjectAsVec struct is a wrapper around a Vec of (&str, Value) pairs. It provides methods to make it easy to migrate from serde_json::Value::Object.

Tuple Fields

0: Vec<(&'ctx str, Value<'ctx>)>

Implementations

impl<'ctx> ObjectAsVec<'ctx>

pub fn as_vec(&self) -> &Vec<(&str, Value<'_>)>

Access to the underlying Vec

pub fn into_vec(self) -> Vec<(&'ctx str, Value<'ctx>)>

Access to the underlying Vec

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

Returns a reference to the value corresponding to the key.

Performance

As this is backed by a Vec, this searches linearly through the Vec as may be much more expensive than a Hashmap for larger Objects.

pub fn get_key_value(&self, key: &str) -> Option<(&str, &Value<'_>)>

Returns the key-value pair corresponding to the supplied key.

Performance

As this is backed by a Vec, this searches linearly through the Vec as may be much more expensive than a Hashmap for larger Objects.

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

An iterator visiting all key-value pairs

pub fn len(&self) -> usize

Returns the number of elements in the object

pub fn is_empty(&self) -> bool

Returns true if the object contains no elements

pub fn keys(&self) -> impl Iterator<Item = &str>

An iterator visiting all keys

pub fn values(&self) -> impl Iterator<Item = &Value<'_>>

An iterator visiting all values

pub fn contains_key(&self, key: &str) -> bool

Returns true if the object contains a value for the specified key.

Performance

As this is backed by a Vec, this searches linearly through the Vec as may be much more expensive than a Hashmap for larger Objects.

Trait Implementations

impl<'ctx> Clone for ObjectAsVec<'ctx>

fn clone(&self) -> ObjectAsVec<'ctx>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'ctx> Debug for ObjectAsVec<'ctx>

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

Formats the value using the given formatter.

impl<'ctx> IntoIterator for ObjectAsVec<'ctx>

type Item = (&'ctx str, Value<'ctx>)

The type of the elements being iterated over.

type IntoIter = IntoIter<<ObjectAsVec<'ctx> as IntoIterator>::Item>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'ctx> PartialEq for ObjectAsVec<'ctx>

fn eq(&self, other: &ObjectAsVec<'ctx>) -> bool

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

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

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

impl<'ctx> Eq for ObjectAsVec<'ctx>

impl<'ctx> StructuralPartialEq for ObjectAsVec<'ctx>