Value

Enum Value 

Source
pub enum Value {
Show 30 variants Null, Boolean(Option<bool>), Int8(Option<i8>), Int16(Option<i16>), Int32(Option<i32>), Int64(Option<i64>), Int128(Option<i128>), UInt8(Option<u8>), UInt16(Option<u16>), UInt32(Option<u32>), UInt64(Option<u64>), UInt128(Option<u128>), Float32(Option<f32>), Float64(Option<f64>), Decimal(Option<Decimal>, u8, u8), Char(Option<char>), Varchar(Option<String>), Blob(Option<Box<[u8]>>), Date(Option<Date>), Time(Option<Time>), Timestamp(Option<PrimitiveDateTime>), TimestampWithTimezone(Option<OffsetDateTime>), Interval(Option<Interval>), Uuid(Option<Uuid>), Array(Option<Box<[Value]>>, Box<Value>, u32), List(Option<Vec<Value>>, Box<Value>), Map(Option<HashMap<Value, Value>>, Box<Value>, Box<Value>), Json(Option<Value>), Struct(Option<Vec<(String, Value)>>, Vec<(String, Value)>), Unknown(Option<String>),
}
Expand description

Strongly-typed, nullable SQL value representation used across Tank.

Variants wrap Option<T>None signifies SQL NULL (except Null which unconditionally represents a NULL of unknown type). Complex variants carry additional shape metadata (element type, length, precision, etc.).

Variants§

§

Null

Untyped NULL placeholder.

§

Boolean(Option<bool>)

§

Int8(Option<i8>)

§

Int16(Option<i16>)

§

Int32(Option<i32>)

§

Int64(Option<i64>)

§

Int128(Option<i128>)

§

UInt8(Option<u8>)

§

UInt16(Option<u16>)

§

UInt32(Option<u32>)

§

UInt64(Option<u64>)

§

UInt128(Option<u128>)

§

Float32(Option<f32>)

§

Float64(Option<f64>)

§

Decimal(Option<Decimal>, u8, u8)

Arbitrary precision decimal with width/scale hints.

§

Char(Option<char>)

§

Varchar(Option<String>)

§

Blob(Option<Box<[u8]>>)

§

Date(Option<Date>)

§

Time(Option<Time>)

§

Timestamp(Option<PrimitiveDateTime>)

§

TimestampWithTimezone(Option<OffsetDateTime>)

§

Interval(Option<Interval>)

§

Uuid(Option<Uuid>)

§

Array(Option<Box<[Value]>>, Box<Value>, u32)

Fixed-size homogeneous array.

§

List(Option<Vec<Value>>, Box<Value>)

Variable length homogeneous list.

§

Map(Option<HashMap<Value, Value>>, Box<Value>, Box<Value>)

Map with homogeneous key/value types.

§

Json(Option<Value>)

§

Struct(Option<Vec<(String, Value)>>, Vec<(String, Value)>)

Struct with named fields and their types.

§

Unknown(Option<String>)

Parsing fallback / unknown driver-provided type.

Implementations§

Source§

impl Value

Source

pub fn same_type(&self, other: &Self) -> bool

Source

pub fn is_null(&self) -> bool

Source

pub fn as_null(&self) -> Value

Source

pub fn try_as(self, value: &Value) -> Result<Value>

Trait Implementations§

Source§

impl AsValue for Value

Source§

fn as_empty_value() -> Value

Return an “empty” (NULL-like) value variant for this type. Used when constructing composite Value containers (arrays, maps) or representing absent optional data. This should never allocate and should not rely on default trait implementations of Self.
Source§

fn as_value(self) -> Value

Convert this value into its owned Value representation. This should perform any necessary wrapping (e.g. collections into List, decimals into Decimal) but avoid lossy transformations unless explicitly documented.
Source§

fn try_from_value(value: Value) -> Result<Self>
where Self: Sized,

Attempt to convert a dynamic Value into Self. Read more
Source§

fn parse(input: impl AsRef<str>) -> Result<Self>
where Self: Sized,

Parse a full string into Self delegating to [AsValue::extract]. Read more
Source§

impl Clone for Value

Source§

fn clone(&self) -> Value

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Value

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for Value

Source§

fn default() -> Value

Returns the “default value” for a type. Read more
Source§

impl Expression for Value

Source§

fn write_query( &self, writer: &dyn SqlWriter, context: &mut Context, out: &mut String, )

Serialize the expression into the output string using the sql writer.
Source§

fn is_ordered(&self) -> bool

Whether this expression carries ordering information.
Source§

impl From<&'static str> for Value

Source§

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

Converts to this type from the input type.
Source§

impl Hash for Value

Source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

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

Feeds a slice of this type into the given Hasher. Read more
Source§

impl OpPrecedence for Value

Source§

fn precedence(&self, _writer: &dyn SqlWriter) -> i32

Lower numbers bind weaker, writers parenthesize when child precedence <= operator precedence.
Source§

impl PartialEq for Value

Source§

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl ToTokens for Value

Source§

fn to_tokens(&self, tokens: &mut TokenStream)

Write self to the given TokenStream. Read more
Source§

fn to_token_stream(&self) -> TokenStream

Convert self directly into a TokenStream object. Read more
Source§

fn into_token_stream(self) -> TokenStream
where Self: Sized,

Convert self directly into a TokenStream object. Read more
Source§

impl Eq for Value

Auto Trait Implementations§

§

impl Freeze for Value

§

impl RefUnwindSafe for Value

§

impl Send for Value

§

impl Sync for Value

§

impl Unpin for Value

§

impl UnwindSafe for Value

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Spanned for T
where T: Spanned + ?Sized,

Source§

fn span(&self) -> Span

Returns a Span covering the complete contents of this syntax tree node, or Span::call_site() if this node is empty.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.