Struct Value 

pub struct Value { /* private fields */ }

A dynamic value.

Implementations

impl Value

pub const fn null() -> Self

Construct a null value.

Examples

use sqlite_ll::Value;

let value = Value::null();
assert!(value.is_null());

pub const fn blob(value: Vec<u8>) -> Self

Construct a blob value.

Examples

use sqlite_ll::Value;

let value = Value::blob(Vec::new());
assert_eq!(value.as_blob(), Some(&[][..]));

pub const fn text(value: String) -> Self

Construct a text value.

Examples

use sqlite_ll::Value;

let value = Value::text(String::new());
assert_eq!(value.as_text(), Some(""));

let value = Value::text(String::from("hello"));
assert_eq!(value.as_text(), Some("hello"));

pub const fn float(value: f64) -> Self

Construct a float value.

Examples

use sqlite_ll::Value;

let value = Value::float(42.0);
assert_eq!(value.as_float(), Some(42.0));

pub const fn integer(value: i64) -> Self

Construct a integer value.

Examples

use sqlite_ll::Value;

let value = Value::integer(42);
assert_eq!(value.as_integer(), Some(42));

pub const fn is_null(&self) -> bool

Return whether the value is Null.

Examples

use sqlite_ll::Value;

let value = Value::null();
assert!(value.is_null());

pub const fn as_blob(&self) -> Option<&[u8]>

Return the binary data if the value is Binary.

Examples

use sqlite_ll::Value;

let value = Value::blob(Vec::new());
assert_eq!(value.as_blob(), Some(&[][..]));

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

Return the string if the value is String.

Examples

use sqlite_ll::Value;

let value = Value::text(String::new());
assert_eq!(value.as_text(), Some(""));

let value = Value::text(String::from("hello"));
assert_eq!(value.as_text(), Some("hello"));

pub const fn as_float(&self) -> Option<f64>

Return the floating-point number if the value is Float.

Examples

use sqlite_ll::Value;

let value = Value::float(42.0);
assert_eq!(value.as_float(), Some(42.0));

pub const fn as_integer(&self) -> Option<i64>

Return the integer number if the value is Integer.

Examples

use sqlite_ll::Value;

let value = Value::integer(42);
assert_eq!(value.as_integer(), Some(42));

pub const fn kind(&self) -> Type

Return the 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 PartialEq for Value

fn eq(&self, other: &Value) -> 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 Bindable for Value

Bindable implementation for a dynamic Value.

Examples

use sqlite_ll::{Connection, Value};

let c = Connection::open_memory()?;
c.execute(r##"
CREATE TABLE users (name TEXT, age INTEGER);
INSERT INTO users (name, age) VALUES ('Alice', NULL), ('Bob', 30);
"##)?;

let mut stmt = c.prepare("SELECT name FROM users WHERE age IS ?")?;
stmt.bind(1, Value::null())?;

let mut names = Vec::new();

while let Some(row) = stmt.next()? {
    names.push(row.read::<String>(0)?);
}

assert_eq!(names, vec![String::from("Alice")]);

impl Readable for Value

impl StructuralPartialEq for Value