Struct PreparedStatement 

pub struct PreparedStatement<'a, V: SQLParam> {
    pub text_segments: Box<[CompactString]>,
    pub params: Box<[Param<'a, V>]>,
    pub sql: CompactString,
}

A pre-rendered SQL statement with parameter placeholders Structure: [text, param, text, param, text] where text segments are pre-rendered and params are placeholders to be bound later

Fields

text_segments: Box<[CompactString]>

Pre-rendered text segments

params: Box<[Param<'a, V>]>

Parameter placeholders (in order)

sql: CompactString

Fully rendered SQL with placeholders for this dialect

Implementations

impl<'a, V: SQLParam> PreparedStatement<'a, V>

pub fn external_param_count(&self) -> usize

Returns the number of external parameter bindings expected. This counts params that need external binding (no pre-set value), deduplicating named params since one binding satisfies all uses.

pub fn bind<T: SQLParam + Into<V>>( &self, param_binds: impl IntoIterator<Item = ParamBind<'a, T>>, ) -> Result<(&str, impl Iterator<Item = V>)>

Bind parameters and return SQL with dialect-appropriate placeholders. Uses $1, $2, ... for PostgreSQL, :name or ? for SQLite, ? for MySQL.

Errors

Returns an error if required parameters are missing or if a named placeholder cannot be resolved from the supplied bindings.

pub fn sql(&self) -> &str

Returns the fully rendered SQL with placeholders.

Trait Implementations

impl<'a, V: Clone + SQLParam> Clone for PreparedStatement<'a, V>

fn clone(&self) -> PreparedStatement<'a, V>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a, V: Debug + SQLParam> Debug for PreparedStatement<'a, V>

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

Formats the value using the given formatter.

impl<V: SQLParam> Display for PreparedStatement<'_, V>

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

Formats the value using the given formatter.

impl<V: SQLParam> From<OwnedPreparedStatement<V>> for PreparedStatement<'_, V>

fn from(value: OwnedPreparedStatement<V>) -> Self

Converts to this type from the input type.

impl<'a, V: SQLParam> From<PreparedStatement<'a, V>> for OwnedPreparedStatement<V>

fn from(prepared: PreparedStatement<'a, V>) -> Self

Converts to this type from the input type.

impl<'a, V: SQLParam> ToSQL<'a, V> for PreparedStatement<'a, V>

fn to_sql(&self) -> SQL<'a, V>

fn into_sql(self) -> SQL<'a, V>

where Self: Sized,

Consume self and return SQL without cloning. Default delegates to to_sql() (which clones). Types that own their SQL (like SQL and SQLExpr) override this to avoid the clone.