Error Trace Rt¶

1

import "std/runtime/error_trace_rt";

ErrorTraceBuffer struct¶

Fixed-capacity backing store for one thread's error return trace. Always accessed through the thread-local instance __err_trace_buffer() hands back - never instantiated directly from Spice source.

Methods¶

reset¶

1

public p ErrorTraceBuffer.reset(string originLoc)

Starts a fresh trace with the given location as its origin (frame 0).

Parameters

push¶

1

public p ErrorTraceBuffer.push(string hopLoc)

Appends a propagation hop to the current trace. A no-op if no origin has been recorded yet. Once the capacity above is hit, further hops are silently dropped, keeping the origin and the earliest hops rather than the most recent ones - a real propagation chain this deep is expected to be exceedingly rare.

Parameters

dump¶

1

public p ErrorTraceBuffer.dump()

Prints every recorded frame. A no-op if there is no active trace.

Functions¶

_spice_errTraceReset¶

1

public p _spice_errTraceReset(string originLoc)

Starts a fresh trace with the given location as its origin (frame 0).

Parameters

_spice_errTracePush¶

1

public p _spice_errTracePush(string hopLoc)

Appends a propagation hop to the current trace.

Parameters

_spice_errTraceDump¶

1

public p _spice_errTraceDump()

Prints every recorded frame of the current thread's trace. A no-op if there is no active trace, which also covers the case where error return tracing was never enabled anywhere along the propagation chain in the first place - callers don't need to check that separately (see Error.dumpTrace() and panic()'s own wiring, both of which call this unconditionally).