Enum Value 

#[non_exhaustive]
pub enum Value {
    Null,
    Bool(bool),
    Integer(i64),
    Float(f64),
    String(String),
    Array(Vec<Value>),
    Object(IndexMap<String, Value>),
}

Unified data model for all supported formats.

Every data format (JSON, CSV, YAML, TOML, XML, etc.) is converted to and from this common representation. The variants cover all primitive and composite data types needed for lossless round-trip conversion.

Examples

use dkit_core::value::Value;

let v = Value::Integer(42);
assert_eq!(v.as_i64(), Some(42));
assert!(v.as_str().is_none());

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Null

JSON null / missing value.

Bool(bool)

Boolean value.

Integer(i64)

64-bit signed integer.

Float(f64)

64-bit floating-point number.

String(String)

UTF-8 string.

Array(Vec<Value>)

Ordered sequence of values.

Object(IndexMap<String, Value>)

Ordered map of string keys to values (insertion order preserved).

Implementations

impl Value

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

Returns the boolean value if this is a Bool, otherwise None.

pub fn as_i64(&self) -> Option<i64>

Returns the integer value if this is an Integer, otherwise None.

pub fn as_f64(&self) -> Option<f64>

Returns the value as f64. Works for both Float and Integer variants.

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

Returns a string slice if this is a String, otherwise None.

pub fn as_array(&self) -> Option<&Vec<Value>>

Returns a reference to the inner Vec if this is an Array, otherwise None.

pub fn as_object(&self) -> Option<&IndexMap<String, Value>>

Returns a reference to the inner IndexMap if this is an Object, otherwise None.

pub fn is_null(&self) -> bool

Returns true if this value is Null.

Trait Implementations

impl Clone for Value

fn clone(&self) -> Value

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Value

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

Formats the value using the given formatter.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Value

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

Formats the value using the given formatter.

impl PartialEq for Value

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Value