Struct Journal 

pub struct Journal<'a, T: Pod + FixedLayout> { /* private fields */ }

An append-only journal of fixed-size entries.

Implementations

impl<'a, T: Pod + FixedLayout> Journal<'a, T>

pub fn from_bytes_mut(data: &'a mut [u8]) -> Result<Self, ProgramError>

Parse a journal from a mutable byte slice.

pub fn from_bytes(data: &[u8]) -> Result<JournalReader<'_, T>, ProgramError>

Create a read-only journal view.

pub fn capacity(&self) -> usize

Maximum number of entries.

pub fn write_head(&self) -> u32

Current write head position.

pub fn total_written(&self) -> u32

Total entries ever written.

pub fn flags(&self) -> u32

Journal flags.

pub fn is_circular(&self) -> bool

Whether circular mode is enabled.

pub fn has_wrapped(&self) -> bool

Whether the journal has wrapped at least once (total_written > capacity).

pub fn entry_count(&self) -> usize

Number of valid entries (min of total_written and capacity).

pub fn append(&mut self, entry: T) -> Result<(), ProgramError>

Append an entry to the journal.

pub fn read(&self, index: usize) -> Result<T, ProgramError>

Read entry at logical index (0 = oldest visible entry).

pub fn latest(&self) -> Result<T, ProgramError>

Read the most recent entry.

pub const fn required_bytes(capacity: usize) -> usize

Bytes required for a journal with the given capacity.

pub fn init(&mut self, circular: bool)

Initialize the journal header (circular or strict).