Struct odbc_api::CursorImpl

pub struct CursorImpl<'open_connection, Stmt: BorrowMut<Statement<'open_connection>>> { /* fields omitted */ }

Cursors are used to process and iterate the result sets returned by executing queries. Created by either a prepared query or direct execution. Usually utilized throught the Cursor trait.

Trait Implementations

impl<'o, S> Cursor for CursorImpl<'o, S> where
    S: BorrowMut<Statement<'o>>, 

fn describe_col(
    &self,
    column_number: u16,
    column_description: &mut ColumnDescription
) -> Result<(), Error>

Fetch a column description using the column index.

fn num_result_cols(&self) -> Result<i16, Error>

Number of columns in result set.

unsafe fn fetch(&mut self) -> Result<bool, Error>

Returns the next set of rows in the result set.

unsafe fn set_row_array_size(&mut self, size: u32) -> Result<(), Error>

Sets the batch size for bulk cursors, if retrieving many rows at once.

unsafe fn set_num_rows_fetched(
    &mut self,
    num_rows: &mut usize
) -> Result<(), Error>

Bind an integer to hold the number of rows retrieved with fetch in the current row set.

unsafe fn set_row_bind_type(&mut self, row_size: u32) -> Result<(), Error>

Sets the binding type to columnar binding for batch cursors.

fn unbind_cols(&mut self) -> Result<(), Error>

Release all column buffers bound by bind_col. Except bookmark column.

unsafe fn bind_col(
    &mut self,
    column_number: u16,
    target: &mut impl CDataMut
) -> Result<(), Error>

Binds application data buffers to columns in the result set

fn is_unsigned_column(&self, column_number: u16) -> Result<bool, Error>

true if a given column in a result set is unsigned or not a numeric type, false otherwise.

fn bind_buffer<B>(
    self,
    row_set_buffer: B
) -> Result<RowSetCursor<Self, B>, Error> where
    B: RowSetBuffer, 

Binds this cursor to a buffer holding a row set.

fn col_type(&self, column_number: u16) -> Result<SqlDataType, Error>

SqlDataType

fn col_concise_type(&self, column_number: u16) -> Result<SqlDataType, Error>

The concise data type. For the datetime and interval data types, this field returns the concise data type; for example, TIME or INTERVAL_YEAR.

fn col_octet_length(&self, column_number: u16) -> Result<isize, Error>

Returns the size in bytes of the columns. For variable sized types the maximum size is returned, excluding a terminating zero.

fn col_display_size(&self, column_number: u16) -> Result<isize, Error>

Maximum number of characters required to display data from the column.

fn col_precision(&self, column_number: u16) -> Result<isize, Error>

Precision of the column.

fn col_scale(&self, column_number: u16) -> Result<isize, Error>

The applicable scale for a numeric data type. For DECIMAL and NUMERIC data types, this is the defined scale. It is undefined for all other data types.

fn col_name(&self, column_number: u16, buf: &mut Vec<u16>) -> Result<(), Error>

The column alias, if it applies. If the column alias does not apply, the column name is returned. If there is no column name or a column alias, an empty string is returned.

fn application_row_descriptor(&self) -> Result<Description<'_>, Error>

fn column_names(&self) -> Result<ColumnNamesIt<'_, Self>, Error>

Use this if you want to iterate over all column names and allocate a String for each one.

impl<'o, S> Drop for CursorImpl<'o, S> where
    S: BorrowMut<Statement<'o>>, 

fn drop(&mut self)

Executes the destructor for this type.