Struct OwnedPreparedStatement 

pub struct OwnedPreparedStatement { /* private fields */ }

A prepared statement that automatically closes itself when dropped.

This is the recommended way to use prepared statements. It holds a weak reference to the connection and automatically closes the statement when dropped.

Example

// Statement automatically closes when it goes out of scope
{
    let stmt = client.prepare("SELECT * FROM users WHERE id = $1")?;
    let rows = client.execute(&stmt, params![42_i32])?;
} // Statement is automatically closed here

Implementations

impl OwnedPreparedStatement

pub fn name(&self) -> &str

Returns the statement name.

pub fn query(&self) -> &str

Returns the original query.

pub fn param_types(&self) -> &[Oid]

Returns the parameter types.

pub fn param_count(&self) -> usize

Returns the number of parameters.

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

Returns the result column descriptions.

pub fn column_count(&self) -> usize

Returns the number of result columns.

pub fn statement(&self) -> &PreparedStatement

Returns a reference to the underlying PreparedStatement.

pub fn close(self) -> Result<()>

Explicitly closes the statement, returning any error.

This is called automatically when the OwnedPreparedStatement is dropped, but errors are silently ignored in that case. Use this method if you need to handle close errors.

Errors

Propagates any error from close_statement — connection mutex poisoning, server-side error during Close/Sync, or wire I/O failure. Returns Ok(()) without contacting the server when the connection has already been dropped.

Trait Implementations

impl Debug for OwnedPreparedStatement

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

Formats the value using the given formatter.

impl Drop for OwnedPreparedStatement

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.