Struct SqlCondition 

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

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

Parameters retain left-to-right placeholder order. Keys, operators, and placeholders are interpolated verbatim; callers must validate or quote them for the target backend. Only values are separated as bind parameters. The condition records where each placeholder token sits, so SqlCondition::render_placeholders rewrites placeholders without touching spliced text that happens to contain the same characters.

Implementations

impl<P> SqlCondition<P>

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

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>, ) -> Self

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

pub fn range(key: impl AsRef<str>, placeholder: &str, lo: P, hi: P) -> Self

Renders <key> >= <placeholder> AND <key> <= <placeholder> bound to lo then hi, e.g. price >= ? AND price <= ?.

pub fn between(key: impl AsRef<str>, placeholder: &str, lo: P, hi: P) -> Self

Renders <key> between <placeholder> and <placeholder> bound to lo then hi, e.g. price between ? and ?.

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

Wraps an already-rendered, parameterless condition such as id is null. The text holds no placeholders, whatever characters it contains.

pub fn and(self, rhs: Self) -> Self

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

pub fn or(self, rhs: Self) -> Self

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

pub fn not(self) -> Self

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 render_placeholders<D: Display>( &self, placeholder: impl FnMut(usize) -> D, ) -> String

Returns the condition with the placeholder for parameter i (zero-based, in SqlCondition::params order) replaced by placeholder(i), e.g. |i| format!("${}", i + 1) for Postgres. Only tokens emitted by the constructors are replaced; keys and SqlCondition::raw text are copied verbatim.

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

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

Trait Implementations

impl<P: Clone> Clone for SqlCondition<P>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: Debug> Debug for SqlCondition<P>

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

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() -> Self

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<Self, __D::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::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.