Utilities/mtctx.utilities/Outcome/Success

Success

@JvmInline

value class Success<T>(val value: T) : Outcome<T>

Represents a successful outcome with a value.

Parameters

value

The value produced by the successful operation.

Constructors

Success

constructor(value: T)

Properties

failed

open val failed: Boolean

Indicates whether the operation failed (opposite of succeeded).

succeeded

open override val succeeded: Boolean

Indicates whether the operation succeeded.

value

val value: T

Functions

exceptionOrNull

open fun exceptionOrNull(): Throwable?

Returns the Throwable of a Failure or null if the outcome is a Success.

flatMap

inline suspend fun <T, R> Outcome<T>.flatMap(transform: suspend (T) -> Outcome<R>): Outcome<R>

Flat-maps the value of a successful Outcome using the provided transform function.

fold

inline suspend fun <T, R> Outcome<T>.fold(onSuccess: suspend (T) -> R, onFailure: suspend (String, Throwable?) -> R): R

Folds the Outcome into a single value by applying onSuccess for a Success or onFailure for a Failure.

getOrNull

open fun getOrNull(): T?

Returns the value of a Success or null if the outcome is a Failure.

map

inline suspend fun <T, R> Outcome<T>.map(transform: suspend (T) -> R): Outcome<R>

Maps the value of a successful Outcome using the provided transform function.

mapCatching

inline suspend fun <T, R> Outcome<T>.mapCatching(transform: suspend (T) -> R): Outcome<R>

Maps the value of a successful Outcome using the provided transform function, catching any exceptions.

mapFailure

inline suspend fun <T> Outcome<T>.mapFailure(transform: suspend (Outcome.Failure) -> Outcome.Failure): Outcome<T>

Maps a Failure using the provided transform function, leaving Success unchanged.

recover

inline suspend fun <T> Outcome<T>.recover(recoverBlock: suspend (Outcome.Failure) -> T): Outcome<T>

Recovers from a Failure by applying the recoverBlock function to produce a new value.

recoverCatching

inline suspend fun <T> Outcome<T>.recoverCatching(recoverBlock: suspend (Outcome.Failure) -> T): Outcome<T>

Recovers from a Failure by applying the recoverBlock function, catching any exceptions.

toResult

open fun toResult(): Result<T>

Converts this Outcome to a Result.

toString

open override fun toString(): String

Returns a string representation of this Success instance.