Enum D1ArgumentValue 

#[non_exhaustive]
pub enum D1ArgumentValue {
    Null,
    Integer(i64),
    Real(f64),
    Text(String),
    Blob(Vec<u8>),
}

One SQLite value on the Rust side of the JavaScript boundary, in either direction: a parameter a query binds, or a value a result row holds.

One type for both, as sqlx’s Any driver has, because both directions are the same thing here – plain values that cross as JavaScript ones. sqlx’s built-in drivers split them only because what they read is a C handle or wire bytes, decoded lazily.

Owned rather than borrowed: sqlx 0.9’s Arguments has no lifetime, and the backends return a whole result set as JavaScript values, leaving nothing on the Rust side for a row to borrow from.

Non-exhaustive so that a backend growing a representation – a BigInt, say – is not a breaking change for Encode impls outside this crate.

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

SQL NULL: JavaScript null.

Integer(i64)

A whole number, within ±(2^53 − 1) because it crosses as a JavaScript number and not a BigInt. A result only holds integers in that range; binding a wider one is an encode error rather than a rounded value.

Real(f64)

Any other number, stored as REAL.

Text(String)

A JavaScript string, stored as TEXT.

Blob(Vec<u8>)

An ArrayBuffer, stored as BLOB.

Implementations

impl Value

pub fn from_number(value: f64) -> Value

A JavaScript number, as the storage class it most likely came from.

JavaScript has one number type, so 3 and 3.0 arrive the same. A whole number in the safe range is taken as an Integer – which is why f64 decodes from Integer as well as Real. Anything else, including whole numbers too large to be exact, is a Real.

pub fn type_info(&self) -> TypeInfo

The value’s storage class.

pub fn is_null(&self) -> bool

Whether the value is NULL.

pub fn int(&self) -> Result<i64, Box<dyn Error + Sync + Send>>

An INTEGER.

Errors

For any other storage class.

pub fn real(&self) -> Result<f64, Box<dyn Error + Sync + Send>>

A REAL, or an INTEGER as one.

Errors

For any other storage class.

pub fn text(&self) -> Result<&str, Box<dyn Error + Sync + Send>>

TEXT.

Errors

For any other storage class.

pub fn blob(&self) -> Result<&[u8], Box<dyn Error + Sync + Send>>

A BLOB, or TEXT as its bytes.

Errors

For any other storage class.

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<(), Error>

Formats the value using the given formatter.

impl PartialEq for Value

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Value