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: PinnedParameterCollection, 

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

Avoid using this unsafe constructor. New instances of this are best constructed using crate::Prepared::bind_parameters.

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

impl<'o, P> Prebound<'o, P>

pub fn params_mut<'a>(&'a mut self) -> P::ViewMut where
    P: ViewPinnedMut<'a, 'o>, 

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