Modulebase-4.23.0.0Haskell2010

GHC.Weak.Finalize

Contents

Handling exceptions
Internal

Synopsis

value setFinalizerExceptionHandler
value getFinalizerExceptionHandler
value printToHandleFinalizerExceptionHandler
value runFinalizerBatch

Packagebase-4.23.0.0
Exports4
LanguageHaskell2010
LicenceBSD-3-Clause
SourceFinalize.hs

Handling exceptions

When an exception is thrown by a finalizer called by the garbage collector, GHC calls a global handler which can be set with setFinalizerExceptionHandler. Note that any exceptions thrown by this handler will be ignored.

valuesetFinalizerExceptionHandler :: (SomeException -> IO ()) -> IO ()

Source#

Set the global action called to report exceptions thrown by weak pointer finalizers to the user.

valuegetFinalizerExceptionHandler :: IO (SomeException -> IO ())

Source#

Get the global action called to report exceptions thrown by weak pointer finalizers to the user.

valueprintToHandleFinalizerExceptionHandler :: Handle -> SomeException -> IO ()

Source#

An exception handler for Handle finalization that prints the error to the given Handle, but doesn't rethrow it.

Internal

valuerunFinalizerBatch

:: Int
-> Array# (State# RealWorld -> State# RealWorld)
-> IO ()

Source#

Deprecated. This function is internal to GHC. It will not be exported in future.

Run a batch of finalizers from the garbage collector. Given an array of finalizers and the length of the array, just call each one in turn.

This is an internal detail of the GHC RTS weak pointer finaliser mechanism. It should no longer be exported from base. There is no good reason to use it. It will be removed in the next major version of base (4.23.*).

See https://github.com/haskell/core-libraries-committee/issues/342