Enum Value 

pub enum Value<'a> {
    Null,
    Bool(bool),
    String(Cow<'a, str>),
    Number(Number),
    Binary(&'a [u8]),
    Date(Date),
    Timestamp(Timestamp),
    TimestampTz(TimestampTz),
    Interval(Interval),
    Array(Vec<Value<'a>>),
    Object(Object<'a>),
}

Represents a JSON or extended JSON value.

This enum supports both standard JSON types (Null, Bool, String, Number, Array, Object) and extended types for specialized data representation (Binary, Date, Timestamp, etc.). The extended types provide additional functionality beyond the JSON specification, making this implementation more suitable for database applications and other systems requiring richer data type support.

Variants

Null

Represents a JSON null value

Bool(bool)

Represents a JSON boolean value (true or false)

String(Cow<'a, str>)

Represents a JSON string value

Number(Number)

Represents a JSON number value with various internal representations

Binary(&'a [u8])

Extended type: Represents binary data not supported in standard JSON Useful for storing raw bytes, images, or other binary content

Date(Date)

Extended type: Represents a calendar date (year, month, day) Stored as days since epoch for efficient comparison and manipulation

Timestamp(Timestamp)

Extended type: Represents a timestamp without timezone information Stored as microseconds since epoch

TimestampTz(TimestampTz)

Extended type: Represents a timestamp with timezone information Includes both timestamp and timezone offset

Interval(Interval)

Extended type: Represents a time interval or duration Useful for time difference calculations and scheduling

Array(Vec<Value<'a>>)

Represents a JSON array of values

Object(Object<'a>)

Represents a JSON object as key-value pairs

Implementations

impl<'a> Value<'a>

pub fn is_scalar(&self) -> bool

pub fn is_object(&self) -> bool

pub fn as_object(&self) -> Option<&Object<'a>>

pub fn is_array(&self) -> bool

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

pub fn is_string(&self) -> bool

pub fn as_str(&self) -> Option<&Cow<'_, str>>

pub fn is_number(&self) -> bool

pub fn as_number(&self) -> Option<&Number>

pub fn is_i64(&self) -> bool

pub fn is_u64(&self) -> bool

pub fn is_f64(&self) -> bool

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

pub fn as_u64(&self) -> Option<u64>

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

pub fn is_boolean(&self) -> bool

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

pub fn is_null(&self) -> bool

pub fn as_null(&self) -> Option<()>

pub fn is_binary(&self) -> bool

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

pub fn is_date(&self) -> bool

pub fn as_date(&self) -> Option<&Date>

pub fn is_timestamp(&self) -> bool

pub fn as_timestamp(&self) -> Option<&Timestamp>

pub fn is_timestamp_tz(&self) -> bool

pub fn as_timestamp_tz(&self) -> Option<&TimestampTz>

pub fn is_interval(&self) -> bool

pub fn as_interval(&self) -> Option<&Interval>

pub fn write_to_vec(&self, buf: &mut Vec<u8>)

Serialize the JSONB Value into a byte stream.

pub fn to_vec(&self) -> Vec<u8>

Serialize the JSONB Value into a byte stream.

pub fn get_by_name_ignore_case(&self, name: &str) -> Option<&Value<'a>>

pub fn array_length(&self) -> Option<usize>

pub fn object_keys(&self) -> Option<Value<'a>>

pub fn eq_variant(&self, other: &Value<'_>) -> bool

pub fn rand_value() -> Value<'static>

generate random JSONB value

Trait Implementations

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

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

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, formatter: &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 Display for Value<'_>

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

Formats the value using the given formatter.

impl<'a, T: Clone + Into<Value<'a>>> From<&'a [T]> for Value<'a>

fn from(f: &'a [T]) -> Self

Converts to this type from the input type.

impl From<&Value> for Value<'_>

fn from(value: &JsonValue) -> Self

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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

fn from((): ()) -> Self

Converts to this type from the input type.

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

fn from(o: Object<'a>) -> Self

Converts to this type from the input type.

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

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

Converts to this type from the input type.

impl From<OrderedFloat<f32>> for Value<'_>

fn from(f: OrderedFloat<f32>) -> Self

Converts to this type from the input type.

impl From<OrderedFloat<f64>> for Value<'_>

fn from(f: OrderedFloat<f64>) -> Self

Converts to this type from the input type.

impl From<String> for Value<'_>

fn from(f: String) -> Self

Converts to this type from the input type.

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

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

Converts to this type from the input type.

impl From<Value> for Value<'_>

fn from(value: JsonValue) -> Self

Converts to this type from the input type.

impl<'a, T: Into<Value<'a>>> From<Vec<T>> for Value<'a>

fn from(f: Vec<T>) -> Self

Converts to this type from the input type.

impl From<bool> for Value<'_>

fn from(f: bool) -> Self

Converts to this type from the input type.

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

fn from(n: f32) -> Self

Converts to this type from the input type.

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

fn from(n: f64) -> Self

Converts to this type from the input type.

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

fn from(n: i16) -> Self

Converts to this type from the input type.

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

fn from(n: i32) -> Self

Converts to this type from the input type.

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

fn from(n: i64) -> Self

Converts to this type from the input type.

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

fn from(n: i8) -> Self

Converts to this type from the input type.

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

fn from(n: isize) -> Self

Converts to this type from the input type.

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

fn from(n: u16) -> Self

Converts to this type from the input type.

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

fn from(n: u32) -> Self

Converts to this type from the input type.

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

fn from(n: u64) -> Self

Converts to this type from the input type.

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

fn from(n: u8) -> Self

Converts to this type from the input type.

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

fn from(n: usize) -> Self

Converts to this type from the input type.

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

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

Creates a value from an iterator.

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

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

Creates a value from an iterator.

impl<'a> PartialEq for Value<'a>

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

impl<'a> StructuralPartialEq for Value<'a>