Struct SqlCondition 

pub struct SqlCondition<P> { /* private fields */ }

A rendered SQL-style condition together with its positional bind parameters.

Shared by the SQL-flavoured vector stores, whose filter algebra differs only in the parameter type P and in the placeholder token their driver expects ($ for Postgres, ? for CQL). The placeholder is therefore supplied by the caller on every leaf constructor rather than baked into this type.

Parameters are collected left to right in the order their placeholders appear in SqlCondition::condition, which is the order drivers bind them in.

Implementations

impl<P> SqlCondition<P>

pub fn binary( key: impl AsRef<str>, op: &str, placeholder: &str, value: P, ) -> SqlCondition<P>

Renders <key> <op> <placeholder> bound to a single parameter, e.g. price >= $.

pub fn list( key: impl AsRef<str>, op: &str, placeholder: &str, values: Vec<P>, ) -> SqlCondition<P>

Renders <key> <op> (<placeholder>, ...) with one placeholder per value, e.g. id IN (?, ?).

pub fn raw(condition: impl Into<String>) -> SqlCondition<P>

Wraps an already-rendered, parameterless condition such as id is null.

pub fn and(self, rhs: SqlCondition<P>) -> SqlCondition<P>

Conjoins two conditions as (lhs) AND (rhs), concatenating their parameters.

pub fn or(self, rhs: SqlCondition<P>) -> SqlCondition<P>

Disjoins two conditions as (lhs) OR (rhs), concatenating their parameters.

pub fn not(self) -> SqlCondition<P>

Negates the condition as NOT (condition), keeping its parameters.

pub fn condition(&self) -> &str

The rendered condition, with placeholders as the caller supplied them.

pub fn params(&self) -> &[P]

The bind parameters, in placeholder order.

pub fn into_parts(self) -> (String, Vec<P>)

Consumes the condition, returning the rendered text and its parameters.

Trait Implementations

impl<P> Clone for SqlCondition<P>

where P: Clone,

fn clone(&self) -> SqlCondition<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P> Debug for SqlCondition<P>

where P: Debug,

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

Formats the value using the given formatter.

impl<P> Default for SqlCondition<P>

Hand-written so that P needs no Default of its own: a parameterless empty condition is meaningful for every parameter type.

fn default() -> SqlCondition<P>

Returns the “default value” for a type.

impl<'de, P> Deserialize<'de> for SqlCondition<P>

where P: Deserialize<'de>,

fn deserialize<__D>( __deserializer: __D, ) -> Result<SqlCondition<P>, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<P> Serialize for SqlCondition<P>

where P: Serialize,

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.