Struct PreparedStatement 

pub struct PreparedStatement { /* private fields */ }

A prepared statement with cached AST and optional execution plan

Implementations

impl PreparedStatement

pub fn new(sql: String, statement: Statement) -> Self

Create a new prepared statement from parsed AST

pub fn sql(&self) -> &str

Get the original SQL

pub fn statement(&self) -> &Statement

Get the cached statement AST

pub fn signature(&self) -> &QuerySignature

Get the query signature

pub fn param_count(&self) -> usize

Get the number of parameters expected

pub fn tables(&self) -> &HashSet<String>

Get the tables referenced by this statement

pub fn cached_plan(&self) -> &CachedPlan

Get the cached execution plan

pub fn bind( &self, params: &[SqlValue], ) -> Result<Statement, PreparedStatementError>

Bind parameters to create an executable statement

For statements without placeholders, returns a clone of the cached statement. For parameterized statements, replaces Placeholder expressions with Literal values directly in the AST, avoiding the overhead of re-parsing.

This is the key performance optimization: binding happens at the AST level, not by string substitution and re-parsing.

Trait Implementations

impl Clone for PreparedStatement

fn clone(&self) -> PreparedStatement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PreparedStatement

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

Formats the value using the given formatter.