Struct JoinClause 

pub struct JoinClause<D: Dialect> { /* private fields */ }

Accumulator passed to join/left_join/… closures to build ON conditions.

The closure receives an empty JoinClause, chains on/on_val/on_raw calls, and returns it; the builder stores the collected conditions.

Implementations

impl<D: Dialect> JoinClause<D>

pub fn new() -> Self

Create an empty accumulator.

pub fn on(self, col: &str, op: &'static str, col2: &str) -> Self

lhs op rhs — both sides are columns (each escaped at compile time).

pub fn on_val(self, col: &str, op: &'static str, val: impl IntoBind) -> Self

col op ? — col escaped, the value bound as a placeholder.

pub fn on_raw(self, sql: &str, binds: Vec<Value>) -> Self

Raw ON SQL fragment with its own binds — the verbatim escape hatch.

Warning: positional placeholder contract

sql is emitted verbatim (it is NOT escaped or renumbered) and binds are appended to the running bind list in order. For Postgres, the caller MUST write $N numbers matching the actual bind position — that is, number of binds already accumulated + 1, +2, … For MySQL/SQLite use ?. No renumbering is performed, so a wrong $N produces a malformed query.

Trait Implementations

impl<D: Dialect> Default for JoinClause<D>

fn default() -> Self

Returns the “default value” for a type.