runtime-core/io.matthewnelson.kmp.tor.runtime.core/UncaughtException/SuppressedHandler

SuppressedHandler

class SuppressedHandler : UncaughtException.Handler(source)

A special Handler utilized within Handler.withSuppression2 lambda which propagates all exceptions caught by Handler.tryCatch2 into a single, root exception (the first one thrown), with all subsequent exceptions added via Throwable.addSuppressed.

Properties

isActive

@get:JvmName(name = "isActive")

val isActive: Boolean

If the Handler.withSuppression2 block has completed.

Functions

invoke

open operator override fun invoke(it: UncaughtException)

tryCatch2

@JvmStatic

inline fun UncaughtException.Handler?.tryCatch2(context: Any, block: () -> Unit)

Helper for wrapping external function calls in order to redirect any uncaught exceptions.

withSuppression2

@JvmStatic

inline fun <T> UncaughtException.Handler?.withSuppression2(block: UncaughtException.SuppressedHandler.() -> T): T

Wraps an existing handler with suppression such that any invocation of tryCatch2 within block lambda is combined into a single UncaughtException, which is then propagated to the current handler (if there even was an UncaughtException).