Struct ScopeGuard 

pub struct ScopeGuard { /* private fields */ }

RAII guard returned by obs::scope! and obs::context!. Dropping pops the frame; for Scope kind frames where any >= ERROR envelope was observed, the tail buffer is flushed back through the active observer with sampling_reason = TAIL_ERROR.

Implementations

impl ScopeGuard

pub fn enter(fields: Vec<ScopeField>, tail_capacity: u16) -> ScopeGuard

Push a Scope frame.

pub fn enter_context(fields: Vec<ScopeField>) -> ScopeGuard

Push a Context frame (no tail buffer).

pub fn enter_with_identity( fields: Vec<ScopeField>, kind: ScopeKind, tail_capacity: u16, name: &'static str, target: &'static str, ) -> ScopeGuard

Push a frame with explicit identity, used by the bridge to stamp (name, target) for obs::SpanTrace.

pub fn enter_with_frame(frame: ScopeFrame) -> ScopeGuard

Push a fully-built ScopeFrame onto the active scope stack. Used by super::ScopeFrameBuilder::push so external crates can build a frame programmatically (instead of via the obs::scope! macro) and own the resulting RAII guard. Spec 94 D7-3.

pub fn into_inner(self) -> ScopeFrame

Detach the guard so the caller can layer it onto a Future::instrument(...) (the future then re-applies the frame on every poll). The frame is popped immediately so the caller doesn’t hold two copies.

Trait Implementations

impl Debug for ScopeGuard

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

Formats the value using the given formatter.

impl Drop for ScopeGuard

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.