Struct WriteBatch 

pub struct WriteBatch { /* private fields */ }

A write batch that buffers page mutations in memory

Use this to amortize fsync costs across multiple operations:

use sqlitegraph::backend::native::v3::write_batch::WriteBatch;
use sqlitegraph::backend::native::v3::index::IndexPage;

let mut batch = WriteBatch::new();
batch.stage_page(IndexPage::new_leaf(1))?;
batch.stage_page(IndexPage::new_leaf(2))?;
batch.stage_page(IndexPage::new_leaf(3))?;
batch.commit(std::path::Path::new("/tmp/db.graph"))?; // Single fsync for all pages

Implementations

impl WriteBatch

pub fn new() -> Self

Create a new empty write batch

pub fn stage_page(&mut self, page: IndexPage) -> NativeResult<()>

Stage a page for writing (in-memory only)

The page is added to the batch but not written to disk yet. Multiple writes to the same page_id will overwrite.

Arguments

• page - The IndexPage to stage

Errors

Returns error if batch is already committed

pub fn len(&self) -> usize

Get the number of pages in this batch

pub fn is_empty(&self) -> bool

Check if batch is empty

pub fn is_committed(&self) -> bool

Check if this batch has been committed

pub fn commit(self, db_path: &Path) -> NativeResult<()>

Commit all staged pages to disk in a single operation

This writes all pages and performs exactly ONE fsync. On failure, partial writes may have occurred but pages remain in dirty state (can be retried).

Arguments

• db_path - Path to the database file

Errors

Returns error if:

• Batch is empty (nothing to commit)
• Batch already committed
• I/O error during write

Trait Implementations

impl Debug for WriteBatch

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

Formats the value using the given formatter.

impl Default for WriteBatch

fn default() -> Self

Returns the “default value” for a type.