Struct odbc_api::Connection

pub struct Connection<'c> { /* fields omitted */ }

The connection handle references storage of all information about the connection to the data source, including status, transaction state, and error information.

Implementations

impl<'c> Connection<'c>

pub fn exec_direct_utf16(
    &mut self,
    query: &U16Str,
    params: impl Parameters
) -> Result<Option<CursorImpl<'_, Statement<'_>>>, Error>

Executes a prepareable statement. This is the fastest way to submit an SQL statement for one-time execution.

Parameters

• query: The text representation of the SQL statement. E.g. "SELECT * FROM my_table;".
• params: ? may be used as a placeholder in the statement text. A type implementing Parameters is used to bind these parameters before executing the statement. You can use () to represent no parameters.

Return

Returns Some if a cursor is created. If None is returned no cursor has been created ( e.g. the query came back empty). Note that an empty query may also create a cursor with zero rows.

pub fn exec_direct(
    &mut self,
    query: &str,
    params: impl Parameters
) -> Result<Option<CursorImpl<'_, Statement<'_>>>, Error>

Executes a prepareable statement. This is the fastest way to submit an SQL statement for one-time execution.

Parameters

• query: The text representation of the SQL statement. E.g. "SELECT * FROM my_table;".
• params: ? may be used as a placeholder in the statement text. A type implementing Parameters is used to bind these parameters before executing the statement. You can use () to represent no parameters.

Return

Returns Some if a cursor is created. If None is returned no cursor has been created ( e.g. the query came back empty). Note that an empty query may also create a cursor with zero rows.

pub fn prepare_utf16(&self, query: &U16Str) -> Result<Prepared<'_>, Error>

Prepares an SQL statement. This is recommended for repeated execution of similar queries.

Parameters

• query: The text representation of the SQL statement. E.g. "SELECT * FROM my_table;". ? may be used as a placeholder in the statement text, to be replaced with parameters during execution.

pub fn prepare(&self, query: &str) -> Result<Prepared<'_>, Error>

Prepares an SQL statement. This is recommended for repeated execution of similar queries.

Parameters

• query: The text representation of the SQL statement. E.g. "SELECT * FROM my_table;". ? may be used as a placeholder in the statement text, to be replaced with parameters during execution.

Trait Implementations

impl<'conn> Drop for Connection<'conn>

fn drop(&mut self)

Executes the destructor for this type.