Struct ErrorMetadata 

pub struct ErrorMetadata { /* private fields */ }

Typed structured metadata attached to an error context.

Unlike the ContextRecord trait (whose entries appear in the error’s Display output), metadata stored here is not visible in terminal output. It is intended for programmatic consumers: serialization, snapshots, structured logs, and API responses.

Supports String, bool, i64, and u64 values via MetadataValue.

Implementations

impl ErrorMetadata

pub fn new() -> Self

pub fn is_empty(&self) -> bool

pub fn as_map(&self) -> &BTreeMap<String, MetadataValue>

pub fn insert<K, V>(&mut self, key: K, value: V)

where K: Into<String>, V: Into<MetadataValue>,

pub fn get(&self, key: &str) -> Option<&MetadataValue>

pub fn get_str(&self, key: &str) -> Option<&str>

pub fn iter(&self) -> impl Iterator<Item = (&String, &MetadataValue)>

pub fn merge_missing(&mut self, other: &ErrorMetadata)

Merge entries from other, keeping existing values.

For each key in other, the value is only inserted if the key does not already exist in self. This implements an inner/first wins strategy useful when merging layered metadata where earlier layers should take priority.

See StructError::context_metadata() for a usage example.

Trait Implementations

impl Clone for ErrorMetadata

fn clone(&self) -> ErrorMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ErrorMetadata

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

Formats the value using the given formatter.

impl Default for ErrorMetadata

fn default() -> ErrorMetadata

Returns the “default value” for a type.

impl PartialEq for ErrorMetadata

fn eq(&self, other: &ErrorMetadata) -> 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 Eq for ErrorMetadata

impl StructuralPartialEq for ErrorMetadata