Struct odbc_api::Prebound

pub struct Prebound<'open_connection, Parameters> { /* private fields */ }

A prepared statement with prebound parameters.

Helps you avoid (potentially costly) ODBC function calls than repeatedly executing the same prepared query with different parameters. Using this instead of crate::Prepared::execute directly results in the parameter buffers only to be bound once and modified between calls, instead of new buffers bound.

Implementations

impl<'o, P> Prebound<'o, P> where
    P: ParameterMutCollection, 

pub unsafe fn new(
    statement: StatementImpl<'o>,
    parameters: P
) -> Result<Self, Error>

Safety

• statement must be a prepared statement.
• parameters will be bound to statement. Must not be invalidated by moving. Nor should any operations which can be performed through a mutable reference be able to invalidate the bindings.

pub fn execute(
    &mut self
) -> Result<Option<CursorImpl<&mut StatementImpl<'o>>>, Error>

Execute the prepared statement

pub fn params_mut(&mut self) -> &mut P::Mut

Provides write access to the bound parameters. Used to change arguments betwenn statement executions.