Cont package:ghc-internal

T

Exception context type.

Cc: Other, Control

See GHC.Prim#continuations. Warning: this can fail with an unchecked exception.

Intended for use with pinned arrays; otherwise very unsafe!

Returns 1# if the object is contained in the CNF, 0# otherwise.

Returns 1# if the object is in any CNF at all, 0# otherwise.

Intended for use with pinned arrays; otherwise very unsafe!

Exception context represents a list of ExceptionAnnotations. These are attached to SomeExceptions via addExceptionContext and can be used to capture various ad-hoc metadata about the exception including backtraces and application-specific context. ExceptionContexts can be merged via concatenation using the Semigroup instance or mergeExceptionContext. Note that GHC will automatically solve implicit constraints of type ExceptionContext with emptyExceptionContext.

Like try but also returns the exception context, which is useful if you intend to rethrow the exception later.

Thrown when the program attempts a continuation capture, but no prompt with the given prompt tag exists in the current continuation.

Add more ExceptionContext to a SomeException.

View the ExceptionContext of a SomeException.

Render ExceptionContext to a human-readable String.

An ExceptionContext containing no annotations.

Merge two ExceptionContexts via concatenation

Wraps a particular exception exposing its ExceptionContext. Intended to be used when catching exceptions in cases where access to the context is desired.

Controls finalization of a ForeignPtr, that is, what should happen if the ForeignPtr becomes unreachable. Visually, these data constructors are appropriate in these scenarios:

Memory backing pointer is
GC-Managed   Unmanaged
Finalizer functions are: +------------+-----------------+
Allowed  | MallocPtr  | PlainForeignPtr |
+------------+-----------------+
Prohibited  | PlainPtr   | FinalPtr        |
+------------+-----------------+