Struct Value

pub struct Value { /* private fields */ }

Ergonomic wrapper around a raw sqlite3_value. It is the caller’s reponsibility to ensure that a given pointer points to a valid sqlite3_value object. There seems to be a 5-10% perf cost when using Value vs calling functions on raw pointers

Implementations

impl Value

pub fn from(value: &*mut sqlite3_value) -> Result<Value>

Create a Value struct from a borrowed sqlite3_value pointer

pub fn at(values: &[*mut sqlite3_value], at: usize) -> Option<Value>

Create a Value struct from a sqlite3_value pointer slice at the given index.

pub fn notnull_or(&self, error: Error) -> Result<&Self>

Ensure that the value’s type isn’t SQLITE_NULL - return the given error as an Err.

pub fn notnull_or_else<F>(&self, err: F) -> Result<&Self>

where F: FnOnce() -> Error,

Ensure that the value’s type isn’t SQLITE_NULL - otherwise call the error function and return as Err.

pub fn text_or_else<F>(&self, error: F) -> Result<&str>

where F: FnOnce(Error) -> Error,

Returns the UTF8 representation of the underlying sqlite_value. Fails if the value type is SQLITE_NULL, or if there’s a UTF8 error on the resulting string.