Struct SpillFile 

pub struct SpillFile { /* private fields */ }

A handle to a temporary spill file

The file is automatically deleted when this handle is dropped. Files are created lazily - no disk I/O occurs until the first write.

Example

use vibesql_executor::memory::SpillFile;
use std::path::Path;

let mut file = SpillFile::new(Path::new("/tmp/vibesql"))?;

// Write sorted run
file.write_all(&serialized_data)?;
file.flush()?;

// Read back
file.seek(SeekFrom::Start(0))?;
let data = file.read_to_vec()?;

// File is automatically deleted when `file` is dropped

Implementations

impl SpillFile

pub fn new(temp_dir: &Path) -> Result<Self>

Create a new spill file in the specified directory

The file is not actually created until the first write.

pub fn with_suffix(temp_dir: &Path, suffix: &str) -> Result<Self>

Create a spill file with a specific name suffix

Useful for debugging - creates files like “vibesql_spill_12345_0_sort_run.tmp”

pub fn path(&self) -> &Path

Get the path to the spill file

pub fn bytes_written(&self) -> usize

Get the number of bytes written to this file

pub fn is_created(&self) -> bool

Check if the file has been created on disk

pub fn write_all(&mut self, data: &[u8]) -> Result<()>

Write data to the spill file

pub fn flush(&mut self) -> Result<()>

Flush buffered data to disk

pub fn prepare_for_read(&mut self) -> Result<()>

Prepare the file for reading

This flushes any pending writes and switches to read mode.

pub fn seek(&mut self, pos: SeekFrom) -> Result<u64>

Seek to a position in the file

pub fn read(&mut self, buf: &mut [u8]) -> Result<usize>

Read data from the spill file

pub fn read_exact(&mut self, buf: &mut [u8]) -> Result<()>

Read exact number of bytes

pub fn read_to_vec(&mut self) -> Result<Vec<u8>>

Read entire file into a Vec

Trait Implementations

impl Drop for SpillFile

fn drop(&mut self)

Executes the destructor for this type.