Struct VectorLog 

pub struct VectorLog { /* private fields */ }

An open, append-only vector log.

Implementations

impl VectorLog

pub fn open(path: &Path, cap: u64) -> Result<(Self, Vec<LogRecord>), OpenError>

Open (creating if absent) the log at path and return every record it holds. A torn tail (a crash mid-append) is dropped and the file truncated back to the last good frame. A complete frame that fails its checksum is corruption: a warning with the dropped byte count is logged, the dropped tail is first copied to <file>.corrupt.<unix ts>, and the file is truncated so appends resume on a frame boundary. A file with the wrong magic, or larger than cap, is OpenError::Corrupt and is left untouched.

pub fn has_room_for(&self, records: &[LogRecord]) -> bool

Whether a batch of records fits under the cap.

pub fn append(&mut self, records: &[LogRecord]) -> Result<()>

Append one batch as a single frame and sync it. Nothing is written when the frame would pass the cap.

pub fn size(&self) -> u64

Bytes in the file.