Control.Exception.Context

Copyright	(c) The University of Glasgow 1998-2002
License	see libraries/base/LICENSE
Maintainer	cvs-ghc@haskell.org
Stability	internal
Portability	non-portable (GHC extensions)
Safe Haskell	None
Language	Haskell2010

data ExceptionContext Source

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.

emptyExceptionContext :: ExceptionContext Source

An ExceptionContext containing no annotations.

Since: base-4.20.0.0

addExceptionAnnotation :: ExceptionAnnotation a => a -> ExceptionContext -> ExceptionContext Source

Construct a singleton ExceptionContext from an ExceptionAnnotation.

Since: base-4.20.0.0

Destructuring

getExceptionAnnotations :: ExceptionAnnotation a => ExceptionContext -> [a] Source

Retrieve all ExceptionAnnotations of the given type from an ExceptionContext.

Since: base-4.20.0.0

getAllExceptionAnnotations :: ExceptionContext -> [SomeExceptionAnnotation] Source

displayExceptionContext :: ExceptionContext -> String Source

Render ExceptionContext to a human-readable String.

Since: base-4.20.0.0