Struct binrw::error::Backtrace

#[non_exhaustive]
pub struct Backtrace {
    pub error: Box<Error>,
    pub frames: Vec<BacktraceFrame>,
}

An error backtrace.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

error: Box<Error>

The source error which caused this backtrace.

This is guaranteed to not itself be a backtrace.

frames: Vec<BacktraceFrame>

The frames which lead to the given error.

The first frame is the innermost frame.

Implementations

impl Backtrace

pub fn new(error: Error, frames: Vec<BacktraceFrame>) -> Self

Creates a new backtrace from a source error and a set of frames.

If the source error is an Error::Backtrace, the given frames are appended to that object and it is unwrapped and used instead of creating a new backtrace. This ensures that Backtrace::error is never a Backtrace and avoids recursion.

Trait Implementations

impl ContextExt for Backtrace

fn with_context<Frame: Into<BacktraceFrame>>(self, frame: Frame) -> Self

Adds a new context frame to the error, consuming the original error.

fn with_message(self, message: impl Into<Cow<'static, str>>) -> Self

Adds a new frame of context to the error with the given message, consuming the original error.

impl Debug for Backtrace

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

Formats the value using the given formatter.

impl Display for Backtrace

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

Formats the value using the given formatter.