Struct Frame 

pub struct Frame { /* private fields */ }

A frame in the exception tree.

Implementations

impl Frame

pub fn error(&self) -> &(dyn Error + Send + Sync + 'static)

Return the error as a reference to Error.

If the error was erased, this is the original error, so it can still be downcast to its actual type.

pub fn location(&self) -> &'static Location<'static>

Return the source code location where this exception frame was created.

The file path is the compiler-provided path, before diagnostic formatting shortens it.

pub fn children(&self) -> &[Frame]

Return explicitly raised child frames.

Native Error::source() values are borrowed from Self::error() and traversed lazily, so they aren’t owned Frame children.

impl Frame

Navigation

pub fn probable_cause(&self) -> Option<&(dyn Error + 'static)>

Follow the unique causal child until reaching a leaf or a branch.

Native Error::source() values, I/O payloads, nested crate::Error graphs, and explicitly raised frames all participate.

An aggregate is the error at a branch that groups two or more diagnostic causes. This is a role in the error tree, not a special concrete error type. For example, Exn::raise_all can attach multiple failed operations to a shared "batch failed" crate::Message. That shared message is the aggregate, so selection stops there rather than arbitrarily choosing one operation’s error:

outer context
└─ batch failed  (aggregate, selected)
   ├─ first operation failed
   └─ second operation failed

All crate::ClassificationMarker values are ignored. Their frames, including nested boundaries, are transparent: their real descendants count as children of the nearest non-marker parent instead. Return None if selection stays at this frame, allowing callers to fall back to Self::error(), even for a classification-only root.

pub fn iter_frames(&self) -> impl Iterator<Item = &Frame> + '_

Iterate over all explicitly created frames in breadth-first order. The first frame is this instance, followed by all explicitly raised children. Native Error::source() values are not frames.

Trait Implementations

impl Debug for Frame

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

Formats the value using the given formatter.

impl Display for Frame

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

Formats the value using the given formatter.

impl<E> From<Exn<E>> for Box<Frame>

where E: Error + Send + Sync + 'static,

fn from(err: Exn<E>) -> Self

Converts to this type from the input type.

impl<E> From<Exn<E>> for Frame

where E: Error + Send + Sync + 'static,

fn from(err: Exn<E>) -> Self

Converts to this type from the input type.

impl From<Frame> for Exn

fn from(frame: Frame) -> Self

Converts to this type from the input type.