Struct ErrorChain 

pub struct ErrorChain { /* private fields */ }

A chain of ErrorContext records representing an error’s call stack.

Errors are pushed from innermost (root cause) to outermost (top-level context). depth returns the number of frames.

Examples

use oximedia_core::error_context::{ErrorContext, ErrorChain};

let root = ErrorContext::new("io", "read", "timeout");
let mut chain = ErrorChain::root(root);
chain.push(ErrorContext::new("demuxer", "read_packet", "I/O error"));
assert_eq!(chain.depth(), 2);

Implementations

impl ErrorChain

pub fn root(ctx: ErrorContext) -> Self

Creates a chain containing a single root (innermost) context.

pub fn empty() -> Self

Creates an empty chain.

pub fn push(&mut self, ctx: ErrorContext)

Pushes an outer context onto the chain.

pub fn depth(&self) -> usize

Returns the number of context frames in the chain.

pub fn is_empty(&self) -> bool

Returns true if the chain contains no frames.

pub fn root_cause(&self) -> Option<&ErrorContext>

Returns the root (innermost / first-cause) context, or None if empty.

pub fn outermost(&self) -> Option<&ErrorContext>

Returns the outermost context (most recently pushed), or None if empty.

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

Returns an iterator over all frames from root to outermost.

pub fn involves(&self, component: &str) -> bool

Returns true if any frame’s component matches component.

Trait Implementations

impl Clone for ErrorChain

fn clone(&self) -> ErrorChain

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ErrorChain

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

Formats the value using the given formatter.

impl Display for ErrorChain

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

Formats the value using the given formatter.