arrow-core/arrow.core.continuations/IorEffectScope

IorEffectScope

class IorEffectScope<E>(semigroup: Semigroup<E>, effect: EffectScope<E>) : EffectScope<E> , Semigroup<E> (source)

Constructors

IorEffectScope

fun <E> IorEffectScope(semigroup: Semigroup<E>, effect: EffectScope<E>)

Functions

attempt

open suspend fun <E, A> attempt(f: suspend EffectScope<E>.() -> A): suspend EffectScope<E>.() -> A

Encloses an action for which you want to catch any shift. attempt is used in combination with catch.

bind

open suspend fun Either<E, B>.bind(): B

Folds Either into Effect, by returning B or a shift with R.

open suspend fun Validated<E, B>.bind(): B

Folds Validated into Effect, by returning B or a shift with R.

open suspend fun EagerEffect<E, B>.bind(): B

Runs the EagerEffect to finish, returning B or shift in case of R, bridging eager computations into suspending.

open suspend fun Effect<E, B>.bind(): B

Runs the Effect to finish, returning B or shift in case of R.

suspend fun Ior<E, B>.bind(): B

open suspend fun Option.bind(shift: () -> E): B

Folds Option into Effect, by returning B or a transforming None into R and shifting the result.

open suspend fun Result.bind(transform: (Throwable) -> E): B

Folds Result into Effect, by returning B or a transforming Throwable into R and shifting the result.

catch

open infix suspend fun <E, A> suspend EffectScope<E>.() -> A.catch(recover: suspend EffectScope<E>.(E) -> A): A

When the Effect has shifted with R it will recover the shifted value to A, and when it ran the computation to completion it will return the value A. catch is used in combination with attempt.

combine

open override fun E.combine(b: E): E

Combine two A values.

ensure

open suspend fun ensure(condition: Boolean, shift: () -> E)

ensure that condition is true, if it's false it will shift with the provided value R. Monadic version of kotlin.require.

maybeCombine

open override fun E.maybeCombine(b: E?): E

plus

open operator override fun E.plus(b: E): E

shift

open suspend override fun shift(r: E): B

Short-circuit the Effect computation with value R.

Extensions

ensureNotNull

suspend fun <R, B : Any> EffectScope<R>.ensureNotNull(value: B?, shift: () -> R): B

Ensure that value is not null. if it's non-null it will be smart-casted and returned if it's false it will shift with the provided value R. Monadic version of kotlin.requireNotNull.