Struct DisplaySource 

pub struct DisplaySource<'a> { /* private fields */ }

A borrowed error together with its optional caller location, intended for diagnostic display.

Errors owned by a crate::exn::Frame have the location captured when that frame was created. The first real source beneath transparent classification markers inherits their frame’s location. Other native std::error::Error::source() values have no location because no caller location was captured for them.

Unlike crate::exn::Frame, this type neither owns the error nor represents relationships in an error tree. This lets crate::Error::iter_errors_with_locations() provide the same lightweight view for the tree-backed and flattened-chain representations.

Its normal Display output appends the location when one is available. Alternate formatting ({source:#}) forwards alternate formatting to the underlying error and always omits the location.

Implementations

impl<'a> DisplaySource<'a>

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

Return the stored error, preserving its concrete type for downcasting.

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

Return the captured or inherited caller location, or None for an ordinary native error source.

Trait Implementations

impl<'a> Clone for DisplaySource<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for DisplaySource<'a>

impl<'a> Debug for DisplaySource<'a>

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

Formats the value using the given formatter.

impl Display for DisplaySource<'_>

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

Formats the value using the given formatter.