Enum BoolExpr 

#[non_exhaustive]
pub enum BoolExpr {
    #[non_exhaustive]
    Constant(bool),
    #[non_exhaustive]
    Compare {
        left: ValueExpr,
        op: BoolOp,
        right: ValueExpr,
    },
    #[non_exhaustive]
    IsNull {
        expr: ValueExpr,
        negated: bool,
    },
    #[non_exhaustive]
    IsBoolean {
        expr: ValueExpr,
        test: BooleanTest,
        negated: bool,
    },
    #[non_exhaustive]
    InList {
        expr: ValueExpr,
        values: Vec<ValueExpr>,
        negated: bool,
    },
    #[non_exhaustive]
    InSubquery {
        expr: ValueExpr,
        query: Box<Stmt>,
        negated: bool,
    },
    #[non_exhaustive]
    Between {
        expr: ValueExpr,
        low: ValueExpr,
        high: ValueExpr,
        negated: bool,
    },
    #[non_exhaustive]
    Like {
        expr: ValueExpr,
        pattern: ValueExpr,
        case_insensitive: bool,
        negated: bool,
        escape: bool,
    },
    #[non_exhaustive]
    SimilarTo {
        expr: ValueExpr,
        pattern: ValueExpr,
        negated: bool,
    },
    #[non_exhaustive]
    Regex {
        expr: ValueExpr,
        pattern: ValueExpr,
        case_insensitive: bool,
        negated: bool,
    },
    #[non_exhaustive]
    Infix {
        left: ValueExpr,
        op: &'static str,
        right: ValueExpr,
        negated: bool,
        checked: bool,
    },
    #[non_exhaustive]
    Any {
        value: ValueExpr,
        array: ValueExpr,
        negated: bool,
    },
    #[non_exhaustive]
    ArrayIsEmpty {
        expr: ValueExpr,
        negated: bool,
    },
    #[non_exhaustive]
    And(Vec<BoolExpr>),
    #[non_exhaustive]
    Or(Vec<BoolExpr>),
    #[non_exhaustive]
    Not(Box<BoolExpr>),
    #[non_exhaustive]
    Exists(Box<Stmt>),
    #[non_exhaustive]
    Raw {
        sql: String,
        params: Vec<Param>,
    },
}

Boolean expression AST.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

#[non_exhaustive]

Constant(bool)

Boolean constant.

#[non_exhaustive]

Compare

Binary comparison.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

left: ValueExpr

Left side.

op: BoolOp

Comparison operator.

right: ValueExpr

Right side.

#[non_exhaustive]

IsNull

IS NULL / IS NOT NULL.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

expr: ValueExpr

Tested expression.

negated: bool

Whether to render IS NOT NULL.

#[non_exhaustive]

IsBoolean

IS TRUE / IS NOT TRUE and related boolean tests.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

expr: ValueExpr

Tested expression.

test: BooleanTest

Boolean test kind.

negated: bool

Whether to negate the test.

#[non_exhaustive]

InList

IN (...) / NOT IN (...).

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

expr: ValueExpr

Tested expression.

values: Vec<ValueExpr>

List values.

negated: bool

Whether to render NOT IN.

#[non_exhaustive]

InSubquery

IN (subquery) / NOT IN (subquery).

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

expr: ValueExpr

Tested expression.

query: Box<Stmt>

Subquery statement.

negated: bool

Whether to render NOT IN.

#[non_exhaustive]

Between

BETWEEN / NOT BETWEEN.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

expr: ValueExpr

Tested expression.

low: ValueExpr

Lower bound.

high: ValueExpr

Upper bound.

negated: bool

Whether to render NOT BETWEEN.

#[non_exhaustive]

Like

LIKE / ILIKE predicate.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

expr: ValueExpr

Tested expression.

pattern: ValueExpr

Pattern expression.

case_insensitive: bool

Whether to render ILIKE.

negated: bool

Whether to negate the predicate.

escape: bool

Whether to add ESCAPE '\'.

#[non_exhaustive]

SimilarTo

SIMILAR TO predicate.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

expr: ValueExpr

Tested expression.

pattern: ValueExpr

Pattern expression.

negated: bool

Whether to negate the predicate.

#[non_exhaustive]

Regex

PostgreSQL regex predicate.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

expr: ValueExpr

Tested expression.

pattern: ValueExpr

Pattern expression.

case_insensitive: bool

Whether to use case-insensitive regex matching.

negated: bool

Whether to negate the predicate.

#[non_exhaustive]

Infix

Custom typed infix predicate.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

left: ValueExpr

Left expression.

op: &'static str

SQL operator token.

right: ValueExpr

Right expression.

negated: bool

Whether to wrap with NOT.

checked: bool

Whether a named DSL helper requires metadata/type checks.

#[non_exhaustive]

Any

value = ANY(array) / negated form.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

value: ValueExpr

Value expression.

array: ValueExpr

Array expression.

negated: bool

Whether to negate the predicate.

#[non_exhaustive]

ArrayIsEmpty

Array-empty predicate.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

expr: ValueExpr

Array expression.

negated: bool

Whether to negate the predicate.

#[non_exhaustive]

And(Vec<BoolExpr>)

Logical conjunction.

#[non_exhaustive]

Or(Vec<BoolExpr>)

Logical disjunction.

#[non_exhaustive]

Not(Box<BoolExpr>)

Logical negation.

#[non_exhaustive]

Exists(Box<Stmt>)

EXISTS (subquery).

#[non_exhaustive]

Raw

Server-owned raw predicate.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

sql: String

Raw SQL using rqb ? placeholders.

params: Vec<Param>

Bind parameters for the raw SQL.

Implementations

impl BoolExpr

pub fn and(exprs: impl IntoIterator<Item = BoolExpr>) -> Self

Builds a logical AND group.

pub fn or(exprs: impl IntoIterator<Item = BoolExpr>) -> Self

Builds a logical OR group.

pub fn negate(expr: BoolExpr) -> Self

Builds a logical NOT.

impl BoolExpr

pub fn validate(&self) -> Result<()>

Validates this boolean expression before SQL rendering.

Trait Implementations

impl Clone for BoolExpr

fn clone(&self) -> BoolExpr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BoolExpr

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

Formats the value using the given formatter.