fold

suspend fun <Error, A, B> Effect<Error, A>.fold(catch: suspend (throwable: Throwable) -> B, recover: suspend (error: Error) -> B, transform: suspend (value: A) -> B): B

invoke the Effect and fold the result:

success transform result of A to a value of B.
raised recover from raised value of Error to a value of B.
exception catch from Throwable by transforming value into B.

This method should never be wrapped in try/catch as it will not throw any unexpected errors, it will only result in CancellationException, or fatal exceptions such as OutOfMemoryError.

suspend fun <Error, A, B> Effect<Error, A>.fold(recover: suspend (error: Error) -> B, transform: suspend (value: A) -> B): B

invoke the Effect and fold the result:

success transform result of A to a value of B.
raised recover from raised value of Error to a value of B.

This function re-throws any exceptions thrown within the Effect.

inline fun <Error, A, B> EagerEffect<Error, A>.fold(catch: (throwable: Throwable) -> B, recover: (error: Error) -> B, transform: (value: A) -> B): B

invoke the EagerEffect and fold the result:

success transform result of A to a value of B.
raised recover from raised value of Error to a value of B.
exception catch from Throwable by transforming value into B.

This method should never be wrapped in try/catch as it will not throw any unexpected errors, it will only result in CancellationException, or fatal exceptions such as OutOfMemoryError.

inline fun <Error, A, B> EagerEffect<Error, A>.fold(recover: (error: Error) -> B, transform: (value: A) -> B): B

invoke the EagerEffect and fold the result:

success transform result of A to a value of B.
raised recover from raised value of Error to a value of B.

This function re-throws any exceptions thrown within the Effect.

@JvmName(name = "_foldOrThrow")

inline fun <Error, A, B> fold(block: Raise<Error>.() -> A, recover: (error: Error) -> B, transform: (value: A) -> B): B

The most general way to execute a computation using Raise. Depending on the outcome of the block, one of the two lambdas is run:

success transform result of A to a value of B.
raised recover from raised value of Error to a value of B.

This function re-throws any exceptions thrown within the Raise block.

@JvmName(name = "_fold")

inline fun <Error, A, B> fold(block: Raise<Error>.() -> A, catch: (throwable: Throwable) -> B, recover: (error: Error) -> B, transform: (value: A) -> B): B

The most general way to execute a computation using Raise. Depending on the outcome of the block, one of the three lambdas is run:

success transform result of A to a value of B.
raised recover from raised value of Error to a value of B.
exception catch from Throwable by transforming value into B.

This method should never be wrapped in try/catch as it will not throw any unexpected errors, it will only result in CancellationException, or fatal exceptions such as OutOfMemoryError.