Struct SpanTrace 

pub struct SpanTrace { /* private fields */ }

A wrapper around tracing_error::SpanTrace.

Implementations

impl SpanTrace

pub fn capture() -> SpanTrace

Captures the currently active span stack from the installed subscriber.

Yields an empty trace when no span is active or the subscriber does not support span traces; check is_captured to tell the two apart.

pub const fn new(inner: SpanTrace) -> SpanTrace

Wraps an existing tracing_error::SpanTrace.

pub fn status(&self) -> SpanTraceStatus

Returns whether this trace was captured, empty, or unsupported.

pub fn is_captured(&self) -> bool

true if a span trace was actually captured (an active span existed and the subscriber supports SpanTrace). An empty/unsupported trace yields no frames and should not be rendered as a SPANTRACE section.

pub fn into_span_trace(self) -> SpanTrace

Consumes the wrapper and returns the underlying tracing_error::SpanTrace.

pub const fn as_span_trace(&self) -> &SpanTrace

Borrows the underlying tracing_error::SpanTrace.

Trait Implementations

impl Capturable for SpanTrace

fn capture() -> SpanTrace

Capture a fresh value at the point the error is constructed.

fn capture_or_extract(source: &dyn Diagnostic) -> SpanTrace

Capture for an error that wraps source, reusing equivalent data already on source when that is more useful than a fresh capture.

impl Clone for SpanTrace

fn clone(&self) -> SpanTrace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpanTrace

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

Formats the value using the given formatter.

impl Display for SpanTrace

Available on crate feature tracing only.

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

Formats the value using the given formatter.

impl From<&SpanTrace> for ErasedSpanTrace

Available on crate feature tracing only.

fn from(st: &SpanTrace) -> ErasedSpanTrace

Converts to this type from the input type.

impl From<SpanTrace> for OptionalSpanTrace

fn from(trace: SpanTrace) -> OptionalSpanTrace

Converts to this type from the input type.

impl PartialEq for SpanTrace

Available on crate feature tracing only.

fn eq(&self, other: &SpanTrace) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl SpanTraceProvider for SpanTrace

Available on crate feature tracing only.

fn with_spans(&self, f: &mut dyn FnMut(&SpanMetadata<'_>, &str) -> bool)

Invoke f once per span, from innermost to outermost, passing the span’s metadata and its formatted fields. Iteration stops early when f returns false.