Enum Value 

pub enum Value {
    Null,
    TinyInt(i8),
    SmallInt(i16),
    Integer(i32),
    BigInt(i64),
    Real(f64),
    Decimal(i128, u8),
    Text(String),
    Bytes(Bytes),
    Boolean(bool),
    Date(i32),
    Time(i64),
    Timestamp(Timestamp),
    Uuid([u8; 16]),
    Json(Value),
    Placeholder(usize),
}

A typed SQL value.

Represents values that can appear in query parameters, row data, and comparison predicates.

Note: Real and Decimal types use total ordering (NaN < -Inf < values < Inf) for comparisons to enable use in B+tree indexes.

Variants

Null

SQL NULL.

TinyInt(i8)

8-bit signed integer (-128 to 127).

SmallInt(i16)

16-bit signed integer (-32,768 to 32,767).

Integer(i32)

32-bit signed integer (-2^31 to 2^31-1).

BigInt(i64)

64-bit signed integer (-2^63 to 2^63-1).

Real(f64)

64-bit floating point (IEEE 754 double precision).

Decimal(i128, u8)

Fixed-precision decimal (value in smallest units, scale).

Stored as (i128, u8) where the second field is the scale. Example: Decimal(12345, 2) represents 123.45

Text(String)

UTF-8 text string.

Bytes(Bytes)

Raw bytes (base64 encoded in JSON).

Boolean(bool)

Boolean value.

Date(i32)

Date (days since Unix epoch).

Time(i64)

Time of day (nanoseconds within day).

Timestamp(Timestamp)

Timestamp (nanoseconds since Unix epoch).

Uuid([u8; 16])

UUID (RFC 4122, 128-bit).

Json(Value)

JSON document (validated).

Placeholder(usize)

Parameter placeholder ($1, $2, etc.) - 1-indexed. This is an intermediate representation used during parsing, and should be bound to actual values before execution.

Implementations

impl Value

pub fn data_type(&self) -> Option<DataType>

Returns the data type of this value.

Returns None for Null and Placeholder since they have no concrete type.

pub fn is_null(&self) -> bool

Returns true if this value is NULL.

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

Returns the value as an i64, if it is a BigInt.

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

Returns the value as a string slice, if it is Text.

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

Returns the value as a bool, if it is Boolean.

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

Returns the value as a Timestamp, if it is Timestamp.

pub fn as_bytes(&self) -> Option<&Bytes>

Returns the value as bytes, if it is Bytes.

pub fn as_tinyint(&self) -> Option<i8>

Returns the value as an i8, if it is a TinyInt.

pub fn as_smallint(&self) -> Option<i16>

Returns the value as an i16, if it is a SmallInt.

pub fn as_integer(&self) -> Option<i32>

Returns the value as an i32, if it is an Integer.

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

Returns the value as an f64, if it is a Real.

pub fn as_decimal(&self) -> Option<(i128, u8)>

Returns the value as a Decimal (value, scale), if it is a Decimal.

pub fn as_uuid(&self) -> Option<&[u8; 16]>

Returns the value as a Uuid, if it is a Uuid.

pub fn as_json(&self) -> Option<&Value>

Returns the value as a Json, if it is a Json.

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

Returns the value as a Date, if it is a Date.

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

Returns the value as a Time, if it is a Time.

pub fn compare(&self, other: &Value) -> Option<Ordering>

Compares two values for ordering.

NULL values are considered less than all non-NULL values. Values of different types return None (incomparable).

For Real values, uses total ordering: NaN < -Inf < values < Inf.

pub fn is_compatible_with(&self, data_type: DataType) -> bool

Checks if this value can be assigned to a column of the given type.

pub fn to_json(&self) -> Value

Converts this value to JSON.

Panics

Panics if the value is a Placeholder (should be bound before conversion).

pub fn from_json(json: &Value, data_type: DataType) -> Result<Self>

Parses a value from JSON with an expected data type.

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

fn default() -> Value

Returns the “default value” for a type.

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 From<&str> for Value

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<[u8; 16]> for Value

fn from(u: [u8; 16]) -> Self

Converts to this type from the input type.

impl From<Bytes> for Value

fn from(b: Bytes) -> Self

Converts to this type from the input type.

impl From<String> for Value

fn from(s: String) -> Self

Converts to this type from the input type.

impl From<Timestamp> for Value

fn from(ts: Timestamp) -> Self

Converts to this type from the input type.

impl From<Value> for Value

fn from(j: Value) -> Self

Converts to this type from the input type.

impl From<bool> for Value

fn from(b: 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<i16> for Value

fn from(v: i16) -> 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 From<i8> for Value

fn from(v: i8) -> Self

Converts to this type from the input type.

impl Hash for Value

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Value

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