Struct TraceBuffer 

pub struct TraceBuffer { /* private fields */ }

Ring buffer for trace events with Andon Cord policy.

Per Dunlap (2002): “A trace with missing input events is worse than no trace at all.”

Implementations

impl TraceBuffer

pub fn new(capacity: usize, policy: BufferPolicy) -> Self

Create a new trace buffer with specified capacity and policy.

pub fn soft_andon(capacity: usize) -> Self

Create a Soft Andon buffer (visual indicator on overflow).

pub fn debug(capacity: usize) -> Self

Create a debug buffer (Andon Cord enabled).

pub fn production(capacity: usize) -> Self

Create a production buffer (drop oldest on overflow).

pub fn push(&mut self, record: FrameRecord) -> Result<(), TraceError>

Push a frame record to the buffer.

In AndonCord mode, this will return Err(BufferFull) if the buffer is full. In DropOldest mode, this will drop the oldest frame to make room. In SoftAndon mode, this will drop oldest but update AndonState for visual feedback.

Errors

Returns TraceError::BufferFull if the buffer is full and using AndonCord policy.

pub const fn andon_state(&self) -> AndonState

Get current Andon state for visual feedback (v1.3).

pub fn try_push(&mut self, record: FrameRecord) -> Result<(), TraceError>

Try to push without blocking.

Errors

Returns TraceError::BufferFull if the buffer is full and using AndonCord policy.

pub fn pop(&mut self) -> Option<FrameRecord>

Pop the oldest frame record from the buffer.

pub fn drain(&mut self, count: usize) -> Vec<FrameRecord>

Drain up to count frames from the buffer.

pub const fn len(&self) -> usize

Get current buffer length.

pub const fn is_empty(&self) -> bool

Check if buffer is empty.

pub const fn is_full(&self) -> bool

Check if buffer is full.

pub const fn capacity(&self) -> usize

Get buffer capacity.

pub const fn frames_dropped(&self) -> u64

Get number of dropped frames (only relevant in DropOldest mode).

pub const fn policy(&self) -> BufferPolicy

Get buffer policy.

pub fn clear(&mut self)

Clear the buffer.

pub fn iter(&self) -> impl Iterator<Item = &FrameRecord>

Iterate over all frames in the buffer (oldest to newest).

Trait Implementations

impl Debug for TraceBuffer

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

Formats the value using the given formatter.