Skip to main content

Module diagnostics

Module diagnostics 

Source
Expand description

Bounded, panic-contained runtime diagnostics. Bounded, non-panicking diagnostics for supportability-critical paths.

Emission never calls Excel, allocates, formats, or invokes user code while another diagnostic is being emitted. Drop and xlAutoFree12 deliberately do not emit events.

Structs§

DiagnosticEvent
Pointer-free fixed-size event. excel_code preserves raw Excel status.

Enums§

DiagnosticCode
Stable machine-readable diagnostic code. Formatting belongs to consumers.
DiagnosticSeverity
Severity assigned by the producer; no formatting or policy is implied.

Traits§

DiagnosticSink
Optional consumer for ordinary process diagnostics.

Functions§

emit
Emit into the bounded process-local ring. Reentrant and poisoned paths drop the event rather than block, recurse, panic, allocate, or call Excel.
set_user_sink
Install or remove the optional process-wide user sink before callbacks. A concurrently emitting callback is never blocked: it simply skips a sink whose configuration lock is unavailable.
snapshot
Snapshot is intentionally for ordinary support tooling, never callbacks.