Struct StatementGuarded

pub struct StatementGuarded<'a, C>
where
    C: Query,
{ /* private fields */ }

a statement guard contains a prepared postgres statement. the guard can be dereferenced or borrowed as Statement which can be used for query apis.

the guard would cancel it’s statement when dropped. generic C type must be a client type impl Query trait to instruct the cancellation.

Implementations

impl<C> StatementGuarded<'_, C>

where C: Query,

pub fn leak(self) -> Statement

leak the statement and it will lose automatic management DOES NOT cause memory leak

Methods from Deref<Target = Statement>

pub fn bind<P>(&self, params: P) -> StatementQuery<'_, P>

where P: AsParams,

bind self to typed value parameters where they are encoded into a valid sql query in binary format

Examples

// prepare a statement with typed parameters.
let stmt = Statement::named("SELECT * FROM users WHERE id = $1 AND age = $2", &[Type::INT4, Type::INT4])
    .execute(&cli).await?;
// bind statement to typed value parameters and start query
let row_stream = stmt.bind([9527_i32, 18]).query(&cli).await?;

pub fn bind_dyn<'p, 't>( &self, params: &'p [&'t (dyn ToSql + Sync)], ) -> StatementQuery<'_, impl ExactSizeIterator<Item = &'t (dyn ToSql + Sync)> + 'p>

Statement::bind for dynamic typed parameters

Examples

// bind to a dynamic typed slice where items have it's own concrete type.
let bind = statement.bind_dyn(&[&9527i32, &"nobody"]);

pub fn params(&self) -> &[Type]

Returns the expected types of the statement’s parameters.

pub fn columns(&self) -> &[Column]

Returns information about the columns returned when the statement is queried.

Trait Implementations

impl<C> AsRef<Statement> for StatementGuarded<'_, C>

where C: Query,

fn as_ref(&self) -> &Statement

Converts this type into a shared reference of the (usually inferred) input type.

impl<C> Deref for StatementGuarded<'_, C>

where C: Query,

type Target = Statement

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<C> Drop for StatementGuarded<'_, C>

where C: Query,

fn drop(&mut self)

Executes the destructor for this type.