Struct TransactionalVtabState 

pub struct TransactionalVtabState<S: Clone> { /* private fields */ }

Snapshot-backed transaction/savepoint state for mutable virtual tables.

Virtual table implementations that keep their authoritative state in memory can use this helper to participate in connection-level BEGIN/COMMIT/ ROLLBACK and savepoint recovery without wiring their own savepoint stack.

Implementations

impl<S: Clone> TransactionalVtabState<S>

pub fn begin(&mut self, snapshot: S)

Mark the start of a virtual-table transaction.

pub fn commit(&mut self)

Drop all transactional snapshots after a successful commit.

pub fn rollback(&mut self) -> Option<S>

Return the transaction-begin snapshot for a full rollback.

pub fn savepoint(&mut self, level: i32, snapshot: S)

Record the current state at savepoint level.

pub fn release(&mut self, level: i32)

Drop savepoint snapshots at level and deeper.

pub fn rollback_to(&mut self, level: i32) -> Option<S>

Return the snapshot recorded for savepoint level, keeping that savepoint active and discarding deeper ones.

If the virtual table joined the transaction after outer savepoints were already active, SQLite only gives it a snapshot for the current level. Falling back to the transaction-begin snapshot lets ROLLBACK TO an older savepoint restore the correct pre-transaction state.

Trait Implementations

impl<S: Clone + Clone> Clone for TransactionalVtabState<S>

fn clone(&self) -> TransactionalVtabState<S>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<S: Debug + Clone> Debug for TransactionalVtabState<S>

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

Formats the value using the given formatter.

impl<S: Clone> Default for TransactionalVtabState<S>

fn default() -> Self

Returns the “default value” for a type.