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. Return the frame location used when formatting this node.

A frame returns its own captured location. A native source inherits the location of the frame whose error owns its source chain, providing formatting context even though no location was captured for the source itself. In contrast, captured_location() reports only locations belonging to the node itself.

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)>

Find the best possible cause:

• in a linear chain of a single error each, it’s the last-most error
• in trees, find the deepest-possible error that has the most leafs as children

Native Error::source() values participate as borrowed children. Return None if there are no children.

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.