Enum Value 

pub enum Value {
    Null,
    Bool(bool),
    I64(i64),
    F64(f64),
    Text(String),
    Blob(Vec<u8>),
    Timestamp(i64),
    Date(i32),
    Time(i64),
    Uuid(u128),
    Json(String),
    Decimal(String),
    Array(Vec<Value>),
    TypedArray {
        element_type: ArrayElementType,
        values: Vec<Value>,
    },
}

A single SQL value returned from or passed to a query.

Covers both the basic scalar types common to all databases and extended types for dates, timestamps, UUIDs, JSON, exact decimals, and arrays.

Variants

Null

SQL NULL.

Bool(bool)

Boolean value.

I64(i64)

64-bit signed integer.

F64(f64)

64-bit floating-point number.

Text(String)

UTF-8 text string.

Blob(Vec<u8>)

Raw binary data.

Timestamp(i64)

Unix timestamp with microsecond precision (microseconds since epoch, UTC). Maps to SQL TIMESTAMP / TIMESTAMPTZ.

Date(i32)

Date-only value as days since Unix epoch (1970-01-01). Maps to SQL DATE.

Time(i64)

Time-of-day value as microseconds since midnight. Maps to SQL TIME.

Uuid(u128)

UUID stored as a 128-bit unsigned integer. Maps to SQL UUID.

Json(String)

JSON or JSONB data stored as a UTF-8 string. Maps to SQL JSON / JSONB.

Decimal(String)

Exact decimal stored as a string representation (e.g. "123.456"). Using a string avoids introducing a big-decimal dependency at the core level while preserving exact precision. Maps to SQL NUMERIC / DECIMAL.

Array(Vec<Value>)

Ordered array of values (e.g. Postgres INTEGER[], TEXT[]).

TypedArray

Like Value::Array but also carries the nominal element type returned by the backend (e.g. PostgreSQL int4[] → TypedArray { element_type: Int4, .. }).

Fields

element_type: ArrayElementType

The nominal SQL element type of this array.

values: Vec<Value>

The array elements.

Implementations

impl Value

pub fn type_name(&self) -> &'static str

Returns the human-readable type name of this value variant.

pub fn is_null(&self) -> bool

Returns true if this value is Value::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 Display for Value

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

Formats the value using the given formatter.

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

fn from(v: &'a Value) -> Self

Borrow a Value as a BorrowedValue with zero allocation.

Text, Blob, Json, and Decimal borrow from the owned Value. Array borrows from a freshly-allocated intermediate Vec of BorrowedValues; use BorrowedValue::to_owned to get back an owned Value when needed.

impl From<&str> for Value

fn from(v: &str) -> Self

Converts to this type from the input type.

impl<T: Into<Value>> From<Option<T>> for Value

fn from(v: Option<T>) -> Self

Converts to this type from the input type.

impl From<String> for Value

fn from(v: String) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for Value

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

Converts to this type from the input type.

impl From<bool> for Value

fn from(v: bool) -> Self

Converts to this type from the input type.

impl From<f64> for Value

fn from(v: f64) -> Self

Converts to this type from the input type.

impl From<i32> for Value

fn from(v: i32) -> Self

Converts to this type from the input type.

impl From<i64> for Value

fn from(v: i64) -> Self

Converts to this type from the input type.

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 PartialOrd for Value

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Value

impl ToSqlValue for Value

Allow a Value to be used directly as a SQL parameter.

This enables fan-out helpers (e.g. MultiConnection) to collect parameter snapshots as Vec<Value> and pass them back to Connection::execute / Connection::query without an intermediate conversion step.

fn to_value(&self) -> Value

Convert self into a Value.