Struct InList 

pub struct InList(/* private fields */);

A list bound as an array parameter for use with rarray.

Implementations

impl InList

pub fn from_i64s(items: impl IntoIterator<Item = i64>) -> Self

Builds an integer-keyed IN list. Pair with ... IN (SELECT value FROM rarray(?)).

pub fn from_blobs<'a>(items: impl IntoIterator<Item = &'a [u8]>) -> Self

Builds a BLOB-keyed IN list. Pair with ... IN (SELECT value FROM rarray(?)); the column is compared directly against the bound blobs, with no hex conversion.

pub fn from_values<T: ToSqlValue>(items: impl IntoIterator<Item = T>) -> Self

Builds an IN list from typed keys, binding each through its column codec. Pair with ... IN (SELECT value FROM rarray(?)).

Prefer this over Self::from_i64s and Self::from_blobs whenever the keys are typed. Going through ToSqlValue binds exactly what the column stores - a BLOB for the types carrying a blob codec, an INTEGER for the scalar ones - so the list cannot disagree with the column it is compared against. Serializing every key to bytes instead would bind blobs against an INTEGER column and silently match nothing.

The codec also produces the bound value directly, so the caller does not have to materialize a Vec<Vec<u8>> to keep borrowed slices alive across the query. A blanket impl covers references, so a &[T] slice of keys can be passed as-is.

Trait Implementations

impl Clone for InList

fn clone(&self) -> InList

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InList

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

Formats the value using the given formatter.

impl PartialEq for InList

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for InList

impl ToSqlValue for InList

fn to_sql_value(&self) -> DbValue

Returns the SQL value bound for this Rust value.