Struct Condition 

pub struct Condition { /* private fields */ }

A composable WHERE / HAVING condition.

A condition is an AND or OR group of parts. Groups nest, so arbitrary boolean shapes can be built without thinking about precedence: OR groups and negations are parenthesised when flattened. An empty condition holds trivially and renders as nothing.

use turso_sql::prelude::*;

let cond = Condition::all()
    .add(Expr::col("active").eq(true))
    .add(Condition::any()
        .add(Expr::col("role").eq("admin"))
        .add(Expr::col("role").eq("owner")));

Implementations

impl Condition

pub fn all() -> Condition

A condition that holds when every part holds (AND).

An empty all() holds trivially.

pub fn any() -> Condition

A condition that holds when any part holds (OR).

An empty any() holds trivially rather than failing, so that a filter built from an empty list of alternatives does not silently exclude every row.

pub fn add(self, part: impl IntoCondition) -> Condition

Adds a part.

Empty nested conditions are dropped rather than added, so an unused sub-group never leaves a stray () in the rendered SQL.

pub fn add_option(self, part: Option<impl IntoCondition>) -> Condition

Adds a part when it is Some.

pub fn not(self) -> Condition

Negates the whole condition.

pub fn is_empty(&self) -> bool

Whether no part has been added.

pub fn len(&self) -> usize

The number of parts.

pub fn into_expr(self) -> Option<Expr>

Flattens the condition into one expression, or None when empty.

Trait Implementations

impl Clone for Condition

fn clone(&self) -> Condition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Condition

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

Formats the value using the given formatter.

impl Default for Condition

fn default() -> Condition

Returns the “default value” for a type.

impl IntoCondition for Condition

fn into_condition(self) -> Condition

Converts into a condition.

impl PartialEq for Condition

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Condition