runtime-core/io.matthewnelson.kmp.tor.runtime.core/UncaughtException/Handler/Companion/withSuppression2

withSuppression2

@JvmStatic

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

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).

If SuppressedHandler reference is leaked outside the withSuppression2 lambda, the UncaughtException will be passed back to the originating non-suppressed Handler.

Nested calls of withSuppression2 will use the root SuppressedHandler, so all tryCatch2 invocations are propagated to a root exception and added as a suppressed exception.

NOTE: If Handler is null, Handler.THROW is used.

e.g.

myHandler.withSuppression2 {
    val suppressed = this

    withSuppression2 {
        val nested = this
        assertEquals(suppressed, nested)
    }
}

Great for loops and stuff.

e.g.

myHandler.withSuppression2 {
    // demonstration purposes
    val suppressedHandler = this

    jobs.forEach { job ->

        // Any UncaughtException generated by tryCatch
        // will be added as a suppressed exception to
        // the first UncaughtException.
        tryCatch2(context = job) { job.cancel(null) }
    }

    // on lambda closure the single UncaughtException
    // (if there is one) will be passed back to
    // myHandler
}