Struct Builder 

pub struct Builder<F: Bsql>(/* private fields */);

Builder for a SQL fragment with bound parameters

Usually created with bsql!.

Implementations

impl Builder<EmptyFragment>

pub const fn new_untracked() -> Self

pub const fn start(loc: &'static CodeLocation) -> Builder<impl Bsql>

Start building a Bsql in the normal way

loc is ignored in release builds.

pub const fn with_location(loc: &'static CodeLocation) -> Builder<impl Bsql>

Make a Bsql that definitely has a code location

impl<F: Bsql> Builder<F>

pub const fn text<'o, T>(self, text: T) -> Builder<impl Bsql + 'o>

where F: 'o, T: Display + Sync + 'o,

Appends a fragment of SQL text.

The SQL text must not contain any bind parameter placeholders, since there isn’t any way to pass the corresponding values.

pub const fn value<'o, V>(self, value: V) -> Builder<impl Bsql + 'o>

where F: 'o, V: ToSql + Sync + 'o,

Appends a single bind value.

SQL text: ?

pub const fn fragment<'o, F2>(self, fragment: F2) -> Builder<impl Bsql + 'o>

where F: 'o, F2: Bsql + 'o,

Appends a SQL fragment with its bound values.

pub const fn array_as_row_value<'o, T, const N: usize>( self, array: [T; N], ) -> Builder<impl Bsql + 'o>

where F: 'o, T: ToSql + Sync + 'o,

Appends an Rust array as a SQL row value

SQL text: (?,?,...)

pub const fn insert_row<'o, R>(self, row: R) -> Builder<impl Bsql + 'o>

where F: 'o, R: AsBsqlRow + 'o,

Appends an struct which implements AsBsqlRow as a row for insert

SQL text: (COL1,COL2,...) VALUES (?,?,...)

Skips rowid columns (marked #[deftly(bsql(rowid))]). (Use AsBsqlRow::with_rowid to include them.)

pub const fn ref_iter_as_row_value<'o, C, I>( self, collection: &'o C, ) -> Builder<impl Bsql + 'o>

where F: 'o, &'o C: IntoIterator<Item = &'o I> + Sync + Copy + 'o, I: ToSql + Sync + 'o,

Appends an Rust reference iterator as a SQL row value.

SQL text: (?,?,...)

Adds from an iterator yielding &impl ToSql + Sync, Supply the iterator as a reference to what is probably a collection, so that it yields references to the contents.

pub fn as_dyn(&self) -> &dyn Bsql

Returns self as a &dyn Bsql

This is sometimes necessary as a generic function due to Rust borrowchk limitations.

Trait Implementations

impl<F: Bsql, G: Bsql> Add<Builder<G>> for Builder<F>

type Output = Concat<Builder<F>, Builder<G>>

The resulting type after applying the + operator.

fn add(self, other: Builder<G>) -> Self::Output

Performs the + operation.

impl<F: Bsql> Bsql for Builder<F>

fn extend_text(&self, s: &mut String)

Extend s with the SQL text for this fragment

fn extend_params<'v, 'p: 'v>(&'p self, p: &mut Vec<DynToSql<'v>>)

Extend p with the bind parameter values for this fragment

fn extend_locs(&self, la: &mut CodeLocationAccumulator)

Extend la with the bsql macro call code locations

fn mk_sql_text(&self) -> String

Returns the SQL text for this fragment as a String

fn mk_params(&self) -> Vec<&dyn ToSql>

Returns an owned Vec of references to the bind parameter values

fn mk_params_for_exec(&self, sql_text: &str) -> Vec<&dyn ToSql>

Gets ready to execute this statement

impl<F: Debug + Bsql> Debug for Builder<F>

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

Formats the value using the given formatter.