Struct TursoStatement 

pub struct TursoStatement { /* private fields */ }

Implementations

impl TursoStatement

pub fn n_change(&self) -> i64

return amount of row modifications (insert/delete operations) made by the most recent executed statement

pub fn parameters_count(&self) -> usize

returns parameters count for the statement

pub fn parameter_name(&self, index: usize) -> Option<String>

Returns the name of the parameter at the given 1-based index, including its SQL prefix (e.g. :name, @name, $name). Returns None for positional-only (?) parameters or out-of-range indices.

pub fn bind_positional( &mut self, index: usize, value: Value, ) -> Result<(), TursoError>

binds positional parameter at the corresponding index (1-based)

pub fn named_position( &mut self, name: impl AsRef<str>, ) -> Result<usize, TursoError>

named parameter position.

The name must include the SQL placeholder prefix, e.g. :name, @name, $name, or ?1.

pub fn step( &mut self, waker: Option<&Waker>, ) -> Result<TursoStatusCode, TursoError>

make one execution step of the statement method returns TursoStatusCode::Done if execution is finished method returns TursoStatusCode::Row if execution generated a row method returns TursoStatusCode::Io if async_io was set and execution needs IO in order to make progress

pub fn execute( &mut self, waker: Option<&Waker>, ) -> Result<TursoExecutionResult, TursoError>

execute statement to completion method returns TursoStatusCode::Done if execution completed method returns TursoStatusCode::Io if async_io was set and execution needs IO in order to make progress

pub fn run_io(&self) -> Result<(), TursoError>

run iteration of the IO backend

pub fn row_value(&self, index: usize) -> Result<Value, TursoError>

get row value as an owned Value

pub fn column_count(&self) -> usize

returns column count

pub fn column_name(&self, index: usize) -> Result<String, TursoError>

returns column name

pub fn column_decltype(&self, index: usize) -> Option<String>

returns column declared type (e.g. “INTEGER”, “TEXT”, “DATETIME”, etc.)

pub fn column_type_info(&self, index: usize) -> Option<ColumnTypeInfo>

Returns rich type information for the column at index.

Wraps turso_core::Statement::get_column_type_info. Returns None when the statement has been finalized, when the index is out of bounds, when the connection does not have the experimental custom- types feature enabled (the underlying call errors and we surface that as “no info”; the C ABI has no error channel), when the statement is in EXPLAIN mode, or when the expression behind the column has no determined affinity.

pub fn finalize( &mut self, waker: Option<&Waker>, ) -> Result<TursoStatusCode, TursoError>

finalize statement execution this method must be called in the end of statement execution (either successfull or not)

pub fn reset(&mut self) -> Result<(), TursoError>

reset internal statement state and bindings

pub fn to_capi(self: Box<Self>) -> *mut turso_statement_t

helper method to get C raw container to the TursoStatement instance this method is used in the capi wrappers

pub unsafe fn ref_from_capi<'a>( value: *const turso_statement_t, ) -> Result<&'a mut Self, TursoError>

helper method to restore TursoStatement ref from C raw container this method is used in the capi wrappers

Safety

value must be a pointer returned from Self::to_capi method

pub unsafe fn box_from_capi(value: *const turso_statement_t) -> Box<Self>

helper method to restore TursoStatement instance from C raw container this method is used in the capi wrappers

Safety

value must be a pointer returned from Self::to_capi method

Trait Implementations

impl Drop for TursoStatement

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.