Enum ValueRef 

pub enum ValueRef<'a> {
    Null,
    Integer(i64),
    Real(f64),
    Text(&'a [u8]),
    Blob(&'a [u8]),
}

A non-owning dynamic type value. Typically, the memory backing this value is owned by SQLite.

See Value for an owning dynamic type value.

Variants

Null

The value is a NULL value.

Integer(i64)

The value is a signed integer.

Real(f64)

The value is a floating point number.

Text(&'a [u8])

The value is a text string.

Blob(&'a [u8])

The value is a blob of data

Implementations

impl ValueRef<'_>

pub fn data_type(&self) -> Type

Returns SQLite fundamental datatype.

impl<'a> ValueRef<'a>

pub fn as_i64(&self) -> Result<i64, FromSqlError>

If self is case Integer, returns the integral value. Otherwise, returns Err(Error::InvalidColumnType).

pub fn as_i64_or_null(&self) -> Result<Option<i64>, FromSqlError>

If self is case Null returns None. If self is case Integer, returns the integral value. Otherwise, returns Err(Error::InvalidColumnType).

pub fn as_f64(&self) -> Result<f64, FromSqlError>

If self is case Real, returns the floating point value. Otherwise, returns Err(Error::InvalidColumnType).

pub fn as_f64_or_null(&self) -> Result<Option<f64>, FromSqlError>

If self is case Null returns None. If self is case Real, returns the floating point value. Otherwise, returns Err(Error::InvalidColumnType).

pub fn as_str(&self) -> Result<&'a str, FromSqlError>

If self is case Text, returns the string value. Otherwise, returns Err(Error::InvalidColumnType).

pub fn as_str_or_null(&self) -> Result<Option<&'a str>, FromSqlError>

If self is case Null returns None. If self is case Text, returns the string value. Otherwise, returns Err(Error::InvalidColumnType).

pub fn as_blob(&self) -> Result<&'a [u8], FromSqlError>

If self is case Blob, returns the byte slice. Otherwise, returns Err(Error::InvalidColumnType).

pub fn as_blob_or_null(&self) -> Result<Option<&'a [u8]>, FromSqlError>

If self is case Null returns None. If self is case Blob, returns the byte slice. Otherwise, returns Err(Error::InvalidColumnType).

pub fn as_bytes(&self) -> Result<&'a [u8], FromSqlError>

Returns the byte slice that makes up this ValueRef if it’s either ValueRef::Blob or ValueRef::Text.

pub fn as_bytes_or_null(&self) -> Result<Option<&'a [u8]>, FromSqlError>

If self is case Null returns None. If self is ValueRef::Blob or ValueRef::Text returns the byte slice that makes up this value

Trait Implementations

impl AsSqlTy for ValueRef<'_>

const SQL_TY: SqlTy

The SQL type corresponding to this type.

type Borrowed<'p> = ValueRef<'p>

The borrowed counterpart of this type (may be Self, e.g. for trivially-copiable types such as integers and floats). This is used e.g. for constructing the Table::PrimaryKey associated type, which in turn serves as the input type of helper queries such as SelectByKey and DeleteByKey.

fn format_check_constraint( column: &dyn Display, formatter: &mut Formatter<'_>, ) -> Result

If the domain of this type requires a CHECK constraint, this method should write out the relevant criteria. The column name will be given as the column argument. If the body of this function doesn’t write anything to the formatter, no CHECK constraint is going to be emitted.

impl<'a> Clone for ValueRef<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ValueRef<'a>

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

Formats the value using the given formatter.

impl<'a> From<&'a [u8]> for ValueRef<'a>

fn from(s: &[u8]) -> ValueRef<'_>

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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

fn from(s: &str) -> ValueRef<'_>

Converts to this type from the input type.

impl<T> From<Option<T>> for ValueRef<'_>

where T: Into<ValueRef<'_>>,

fn from(s: Option<T>) -> ValueRef<'_>

Converts to this type from the input type.

impl From<ValueRef<'_>> for Value

fn from(borrowed: ValueRef<'_>) -> Value

Converts to this type from the input type.

impl Param for ValueRef<'_>

const PREFIX: ParamPrefix = ParamPrefix::Question

Primitives are bound as positional parameters, hence the prefix is ‘?’

fn bind(&self, statement: &mut Statement<'_>) -> Result<()>

Binds the primitive or the field(s) of a tuple to a raw rusqlite::Statement.

impl<'a> PartialEq for ValueRef<'a>

fn eq(&self, other: &ValueRef<'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> Copy for ValueRef<'a>

impl<'a> StructuralPartialEq for ValueRef<'a>