backtrace

Struct BacktraceFmt

Source
pub struct BacktraceFmt<'a, 'b> { /* private fields */ }
Expand description

A formatter for backtraces.

This type can be used to print a backtrace regardless of where the backtrace itself comes from. If you have a Backtrace type then its Debug implementation already uses this printing format.

Implementations§

Source§

impl<'a, 'b> BacktraceFmt<'a, 'b>

Source

pub fn new( fmt: &'a mut Formatter<'b>, format: PrintFmt, print_path: &'a mut (dyn FnMut(&mut Formatter<'_>, BytesOrWideString<'_>) -> Result + 'b), ) -> Self

Create a new BacktraceFmt which will write output to the provided fmt.

The format argument will control the style in which the backtrace is printed, and the print_path argument will be used to print the BytesOrWideString instances of filenames. This type itself doesn’t do any printing of filenames, but this callback is required to do so.

Source

pub fn add_context(&mut self) -> Result

Prints a preamble for the backtrace about to be printed.

This is required on some platforms for backtraces to be fully symbolicated later, and otherwise this should just be the first method you call after creating a BacktraceFmt.

Source

pub fn frame(&mut self) -> BacktraceFrameFmt<'_, 'a, 'b>

Adds a frame to the backtrace output.

This commit returns an RAII instance of a BacktraceFrameFmt which can be used to actually print a frame, and on destruction it will increment the frame counter.

Source

pub fn finish(&mut self) -> Result

Completes the backtrace output.

This is currently a no-op but is added for future compatibility with backtrace formats.

Source

pub fn message(&mut self, msg: &str) -> Result

Inserts a message in the backtrace output.

This allows information to be inserted between frames, and won’t increment the frame_index unlike the frame method.

Source

pub fn formatter(&mut self) -> &mut Formatter<'b>

Return the inner formatter.

This is used for writing custom information between frames with write! and writeln!, and won’t increment the frame_index unlike the frame method.

Auto Trait Implementations§

§

impl<'a, 'b> Freeze for BacktraceFmt<'a, 'b>

§

impl<'a, 'b> !RefUnwindSafe for BacktraceFmt<'a, 'b>

§

impl<'a, 'b> !Send for BacktraceFmt<'a, 'b>

§

impl<'a, 'b> !Sync for BacktraceFmt<'a, 'b>

§

impl<'a, 'b> Unpin for BacktraceFmt<'a, 'b>

§

impl<'a, 'b> !UnwindSafe for BacktraceFmt<'a, 'b>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.