Enum Value

pub enum Value<'a> {
    Null,
    Bool(bool),
    Integer(Integer),
    Float(Float),
    Bytes(Cow<'a, [u8]>),
    String(Cow<'a, str>),
    Array(VecDeque<Self>),
    Map(VecDeque<(Self, Self)>),
}

Generic value that can contain any value in our data format. It can be deserialized and serialized to be exactly as when serializing or deserializing with the given type.

Note: Cloneing this value will not borrow from owned values. For that, you need to call Value::borrow_clone.

Variants

Null

Null / None / Unit type.

Bool(bool)

Bool value.

Integer(Integer)

Integer value.

Float(Float)

Float value.

Bytes(Cow<'a, [u8]>)

Bytes value.

String(Cow<'a, str>)

String value.

Array(VecDeque<Self>)

Sequence value.

Map(VecDeque<(Self, Self)>)

Map value (ordered).

Implementations

impl<'a> Value<'a>

pub fn borrow_clone(&self) -> Value<'_>

Clone this value, borrowing the owned data where possible.

pub fn into_owned(self) -> OwnedValue

Make value 'static by cloning all borrowed data.

pub fn deserialize_as<'de, T>(self) -> Result<T>

where T: Deserialize<'de>, 'a: 'de,

Use this generic Value to deserialize into the given concrete type.

pub fn is_empty(&self) -> bool

Return whether the value is empty. This is the case if:

• The value is Value::Null.
• The value is Value::Bytes or Value::String of length 0.
• The value is Value::Array or Value::Map without items.

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

Return the inner bool if this is a Value::Bool.

pub const fn as_int(&self) -> Option<Integer>

Return the inner int if this is a Value::Integer.

pub const fn as_float(&self) -> Option<Float>

Return the inner float if this is a Value::Float.

pub fn as_bytes(&self) -> Option<&[u8]>

Return the inner bytes if this is a Value::Bytes.

pub fn as_string(&self) -> Option<&str>

Return the inner string if this is a Value::String.

pub const fn as_array(&self) -> Option<&VecDeque<Value<'a>>>

Return the inner array if this is a Value::Array.

pub const fn as_map(&self) -> Option<&VecDeque<(Value<'a>, Value<'a>)>>

Return the inner map if this is a Value::Map.

pub fn into_values(self) -> Iter<Value<'static>>

Iterate over the inner values if this is a Value::Array or Value::Map.

Trait Implementations

impl<'a> Clone for Value<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Value<'a>

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

Formats the value using the given formatter.

impl<'a> Default for Value<'a>

fn default() -> Value<'a>

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Value<'de>

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a> Display for Value<'a>

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

Formats the value using the given formatter.

impl<'a> From<&'a [u8]> for Value<'a>

fn from(value: &'a [u8]) -> Self

Converts to this type from the input type.

impl<'a, 'de> From<&'a Value<'de>> for Unexpected<'a>

fn from(value: &'a Value<'de>) -> Self

Converts to this type from the input type.

impl<'a> From<&'a str> for Value<'a>

fn from(value: &'a str) -> Self

Converts to this type from the input type.

impl<'a> From<()> for Value<'a>

fn from(_: ()) -> Self

Converts to this type from the input type.

impl<'a> From<Cow<'a, [u8]>> for Value<'a>

fn from(value: Cow<'a, [u8]>) -> Self

Converts to this type from the input type.

impl<'a> From<Cow<'a, str>> for Value<'a>

fn from(value: Cow<'a, str>) -> Self

Converts to this type from the input type.

impl<'a> From<Option<Value<'a>>> for Value<'a>

fn from(value: Option<Value<'a>>) -> Self

Converts to this type from the input type.

impl<'a> From<String> for Value<'a>

fn from(value: String) -> Self

Converts to this type from the input type.

impl<'a> From<Vec<u8>> for Value<'a>

fn from(value: Vec<u8>) -> Self

Converts to this type from the input type.

impl<'a> From<VecDeque<(Value<'a>, Value<'a>)>> for Value<'a>

fn from(value: VecDeque<(Value<'a>, Value<'a>)>) -> Self

Converts to this type from the input type.

impl<'a> From<VecDeque<Value<'a>>> for Value<'a>

fn from(value: VecDeque<Value<'a>>) -> Self

Converts to this type from the input type.

impl<'a> From<bool> for Value<'a>

fn from(value: bool) -> Self

Converts to this type from the input type.

impl<'a> From<f32> for Value<'a>

fn from(value: f32) -> Self

Converts to this type from the input type.

impl<'a> From<f64> for Value<'a>

fn from(value: f64) -> Self

Converts to this type from the input type.

impl<'a> From<i128> for Value<'a>

fn from(value: i128) -> Self

Converts to this type from the input type.

impl<'a> From<i16> for Value<'a>

fn from(value: i16) -> Self

Converts to this type from the input type.

impl<'a> From<i32> for Value<'a>

fn from(value: i32) -> Self

Converts to this type from the input type.

impl<'a> From<i64> for Value<'a>

fn from(value: i64) -> Self

Converts to this type from the input type.

impl<'a> From<i8> for Value<'a>

fn from(value: i8) -> Self

Converts to this type from the input type.

impl<'a> From<isize> for Value<'a>

fn from(value: isize) -> Self

Converts to this type from the input type.

impl<'a> From<u128> for Value<'a>

fn from(value: u128) -> Self

Converts to this type from the input type.

impl<'a> From<u16> for Value<'a>

fn from(value: u16) -> Self

Converts to this type from the input type.

impl<'a> From<u32> for Value<'a>

fn from(value: u32) -> Self

Converts to this type from the input type.

impl<'a> From<u64> for Value<'a>

fn from(value: u64) -> Self

Converts to this type from the input type.

impl<'a> From<u8> for Value<'a>

fn from(value: u8) -> Self

Converts to this type from the input type.

impl<'a> From<usize> for Value<'a>

fn from(value: usize) -> Self

Converts to this type from the input type.

impl<'a, K, V> FromIterator<(K, V)> for Value<'a>

where K: Into<Value<'a>>, V: Into<Value<'a>>,

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

Creates a value from an iterator.

impl<'a, T> FromIterator<T> for Value<'a>

where T: Into<Value<'a>>,

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

Creates a value from an iterator.

impl<'a> PartialEq<[u8]> for Value<'a>

fn eq(&self, other: &[u8]) -> 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<'a> PartialEq<bool> for Value<'a>

fn eq(&self, other: &bool) -> 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<'a> PartialEq<f32> for Value<'a>

fn eq(&self, other: &f32) -> 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<'a> PartialEq<f64> for Value<'a>

fn eq(&self, other: &f64) -> 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<'a> PartialEq<i128> for Value<'a>

fn eq(&self, other: &i128) -> 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<'a> PartialEq<str> for Value<'a>

fn eq(&self, other: &str) -> 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<'a> PartialEq<u128> for Value<'a>

fn eq(&self, other: &u128) -> 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<'a> PartialEq for Value<'a>

fn eq(&self, other: &Self) -> 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<'a> Serialize for Value<'a>

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

where S: Serializer,

Serialize this value into the given Serde serializer.