Struct PreparedStatement 

pub struct PreparedStatement<'c, 'db> { /* private fields */ }

A prepared SQL statement bound to a Connection.

Implementations

impl<'c, 'db> PreparedStatement<'c, 'db>

pub fn sql(&self) -> &str

The original SQL text.

pub fn param_count(&self) -> usize

Number of positional parameters ($1, $2, …) this statement expects.

pub fn parameter_count(&self) -> usize

Alias of Self::param_count matching rusqlite’s name.

pub fn column_count(&self) -> usize

Number of output columns. Zero for non-SELECT statements.

pub fn column_names(&self) -> &[String]

Output column names in declaration order.

pub fn column_name(&self, i: usize) -> Option<&str>

Output column name at index i, if any.

pub fn column_index(&self, name: &str) -> Option<usize>

Position of the column named name, if present.

pub fn readonly(&self) -> bool

True if the statement is read-only (SELECT or EXPLAIN).

pub fn is_explain(&self) -> bool

True if the statement is an EXPLAIN.

pub fn execute(&self, params: &[Value]) -> Result<u64>

Execute the statement; returns rows affected (0 for SELECT/DDL).

pub fn query(&self, params: &[Value]) -> Result<Rows<'_>>

Execute and return a stepping Rows<'_> iterator.

Streams rows directly from the B+ tree for simple SELECT [cols] FROM t shapes (no WHERE/ORDER BY/aggregate/join). Materializes internally for everything else — same user-visible API either way.

DML statements execute the mutation and yield an immediately-exhausted Rows (matching rusqlite semantics).

pub fn query_collect(&self, params: &[Value]) -> Result<QueryResult>

Execute and return the fully-materialized QueryResult.

Equivalent to self.query(params)?.collect() but slightly more direct.

pub fn query_row<T, F>(&self, params: &[Value], f: F) -> Result<T>

where F: FnOnce(&Row<'_>) -> Result<T>,

Run the query and pass the first row to f.

Returns SqlError::QueryReturnedNoRows if the query produced zero rows. Extra rows after the first are ignored (matches rusqlite’s query_row).

pub fn exists(&self, params: &[Value]) -> Result<bool>

True if the query returns at least one row (DML returns n > 0).

For streamable SELECTs this short-circuits on the first matching row without materializing the rest.