Result<T extends Object> class
sealed
A Monad that represents the result of an operation: every Result is either Ok and contains a success value, or Err and contains an error value.
- Inheritance
- Implemented types
-
- SyncImpl<
T>
- SyncImpl<
- Available extensions
- FlattenResultExt2
- FlattenResultExt3
- FlattenResultExt4
- FlattenResultExt5
- FlattenResultExt6
- FlattenResultExt7
- FlattenResultExt8
- FlattenResultExt9
- MapMonadExt2
- MapMonadExt3
- MapMonadExt4
- MapMonadExt5
- MapMonadExt6
- MapMonadExt7
- MapMonadExt8
- MapMonadExt9
- MapMonadExt10
- SwapResultAsyncExt
- SwapResultErrExt
- SwapResultNoneExt
- SwapResultOkExt
- SwapResultOptionExt
- SwapResultResolvableExt
- SwapResultSomeExt
- SwapResultSyncExt
- ToUnitOnObjectMonad
- ToUnitOnObjectResult
- ToVoidOnMonadExt
- ToVoidOnResultExt
- WrapOnMonadExt
- WrapOnResultExt
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
-
props
→ List<
Object?> -
The list of properties that will be used to determine whether
two instances are equal.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- stringify → bool?
-
If set to
true
, the toString method will be overridden to output this instance's props.no setterinherited -
value
→ FutureOr<
Object> -
finalinherited
Methods
-
asResult(
) → Result< T> -
Returns
this
as a base Result type. -
end(
) → void -
Suppresses the linter error
must_use_monad
.override -
err(
) → Option< Err< T> > - Safely gets the Err instance. Returns a Some on Err, or a None on Ok.
-
errOr(
Result< T> other) → Result<T> -
Returns this if it's Err, otherwise returns the
other
Result. -
flatMap<
R extends Object> (Result< R> noFutures(T value)) → Result<R> -
Maps a
Result<T>
toResult<R>
by applying a function that returns another Result. -
flatten(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt9 extensionResult< >Result< >Result< >Result< >Result< >Result< >Result< >T> > -
flatten(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt2 extensionT> > -
flatten(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt3 extensionResult< >T> > -
flatten(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt4 extensionResult< >Result< >T> > -
flatten(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt5 extensionResult< >Result< >Result< >T> > -
flatten(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt6 extensionResult< >Result< >Result< >Result< >T> > -
flatten(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt7 extensionResult< >Result< >Result< >Result< >Result< >T> > -
flatten(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt8 extensionResult< >Result< >Result< >Result< >Result< >Result< >T> > -
flatten2(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt2 extensionT> > -
flatten3(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt3 extensionResult< >T> > -
flatten4(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt4 extensionResult< >Result< >T> > -
flatten5(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt5 extensionResult< >Result< >Result< >T> > -
flatten6(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt6 extensionResult< >Result< >Result< >Result< >T> > -
flatten7(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt7 extensionResult< >Result< >Result< >Result< >Result< >T> > -
flatten8(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt8 extensionResult< >Result< >Result< >Result< >Result< >Result< >T> > -
flatten9(
) → Result< T> -
Available on Result<
Result< , provided by the FlattenResultExt9 extensionResult< >Result< >Result< >Result< >Result< >Result< >Result< >T> > -
fold(
Result< Object> ? onOk(Ok<T> ok), Result<Object> ? onErr(Err<T> err)) → Result<Object> - Folds the two cases of this Result into a single new Result.
-
ifErr(
void noFutures(Result< T> self, Err<T> err)) → Result<T> - Performs a side-effect with the contained error if this is an Err.
-
ifOk(
void noFutures(Result< T> self, Ok<T> ok)) → Result<T> - Performs a side-effect with the contained value if this is an Ok.
-
isErr(
) → bool -
Returns
true
if this Result is an Err. -
isOk(
) → bool -
Returns
true
if this Result is an Ok. -
map<
R extends Object> (R noFutures(T value)) → Result< R> -
Transforms the contained value using the mapper function
noFutures
while preserving the Monad's structure.override -
map10<
R extends Object> (R mapper(T)) → TResolvableOption< Object> -
Available on Monad<
Monad< , provided by the MapMonadExt10 extensionMonad< >Monad< >Monad< >Monad< >Monad< >Monad< >Monad< >Monad< >Object> > -
map2<
R extends Object> (R mapper(T)) → TResolvableOption< Object> -
Available on Monad<
Monad< , provided by the MapMonadExt2 extensionObject> > -
map3<
R extends Object> (R mapper(T)) → TResolvableOption< Object> -
Available on Monad<
Monad< , provided by the MapMonadExt3 extensionMonad< >Object> > -
map4<
R extends Object> (R mapper(T)) → TResolvableOption< Object> -
Available on Monad<
Monad< , provided by the MapMonadExt4 extensionMonad< >Monad< >Object> > -
map5<
R extends Object> (R mapper(T)) → TResolvableOption< Object> -
Available on Monad<
Monad< , provided by the MapMonadExt5 extensionMonad< >Monad< >Monad< >Object> > -
map6<
R extends Object> (R mapper(T)) → TResolvableOption< Object> -
Available on Monad<
Monad< , provided by the MapMonadExt6 extensionMonad< >Monad< >Monad< >Monad< >Object> > -
map7<
R extends Object> (R mapper(T)) → TResolvableOption< Object> -
Available on Monad<
Monad< , provided by the MapMonadExt7 extensionMonad< >Monad< >Monad< >Monad< >Monad< >Object> > -
map8<
R extends Object> (R mapper(T)) → TResolvableOption< Object> -
Available on Monad<
Monad< , provided by the MapMonadExt8 extensionMonad< >Monad< >Monad< >Monad< >Monad< >Monad< >Object> > -
map9<
R extends Object> (R mapper(T)) → TResolvableOption< Object> -
Available on Monad<
Monad< , provided by the MapMonadExt9 extensionMonad< >Monad< >Monad< >Monad< >Monad< >Monad< >Monad< >Object> > -
mapErr(
Err< T> noFutures(Err<T> err)) → Result<T> - Transforms the inner Err instance if this is an Err.
-
mapOk(
Ok< T> noFutures(Ok<T> ok)) → Result<T> - Transforms the inner Ok instance if this is an Ok.
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
ok(
) → Option< Ok< T> > - Safely gets the Ok instance. Returns a Some on Ok, or a None on Err.
-
okOr(
Result< T> other) → Result<T> -
Returns this if it's Ok, otherwise returns the
other
Result. -
orNull(
) → T? -
Returns the contained Ok value or
null
. -
raw(
{required FutureOr< Object> onErr(Err<Object> err), required FutureOr<Object> onNone()}) → FutureOr<Object> -
The low-level primitive for reducing a Monad chain. It recursively
unwraps all Monad layers to return the innermost raw value, forcing the
caller to handle terminal states via callbacks.
inherited
-
rawAsync(
) → Async< Object> -
Reduces any Monad chain to a single Async.
inherited
-
rawSync(
) → Sync< Object> -
Safely reduces any Monad chain to a single Sync.
inherited
-
reduce<
R extends Object> () → TResolvableOption< R> -
Reduces any nested Monad structure into a single TResolvableOption.
inherited
-
swap(
) → Sync< Result< T> > -
Available on Result<
Sync< , provided by the SwapResultSyncExt extensionT> > -
swap(
) → Some< Result< T> > -
Available on Result<
Some< , provided by the SwapResultSomeExt extensionT> > -
swap(
) → Resolvable< Result< T> > -
Available on Result<
Resolvable< , provided by the SwapResultResolvableExt extensionT> > -
swap(
) → Option< Result< T> > -
Available on Result<
Option< , provided by the SwapResultOptionExt extensionT> > -
swap(
) → Ok< Result< T> > -
Available on Result<
Ok< , provided by the SwapResultOkExt extensionT> > -
swap(
) → Result< T> -
Available on Result<
Err< , provided by the SwapResultErrExt extensionT> > -
swap(
) → Option< Result< T> > -
Available on Result<
None< , provided by the SwapResultNoneExt extensionT> > -
swap(
) → Async< Result< T> > -
Available on Result<
Async< , provided by the SwapResultAsyncExt extensionT> > -
toString(
) → String -
A string representation of this object.
inherited
-
toUnit(
) → Monad< Unit> -
Available on Monad<
Object> , provided by the ToUnitOnObjectMonad extension -
toUnit(
) → Result< Unit> -
Available on Result<
Object> , provided by the ToUnitOnObjectResult extension -
toVoid(
) → Monad< void> -
Available on Monad<
T> , provided by the ToVoidOnMonadExt extension -
toVoid(
) → Result< void> -
Available on Result<
T> , provided by the ToVoidOnResultExt extension -
transf<
R extends Object> ([R noFutures(T e)?]) → Result< R> -
Transforms the Monad's generic type from
T
toR
.override -
unwrap(
) → T -
Strongly discouraged: Unsafely returns the contained value.
override
-
unwrapOr(
T fallback) → T -
Returns the contained value, or the
fallback
if the Monad is in an Err or None state.override -
wrapInAsync(
) → Async< M> -
Available on M, provided by the WrapOnMonadExt extension
-
wrapInOk(
) → Ok< M> -
Available on M, provided by the WrapOnMonadExt extension
-
wrapInResolvable(
) → Resolvable< M> -
Available on M, provided by the WrapOnMonadExt extension
-
wrapInSome(
) → Some< M> -
Available on M, provided by the WrapOnMonadExt extension
-
wrapInSync(
) → Sync< M> -
Available on M, provided by the WrapOnMonadExt extension
-
wrapValueInAsync(
) → Monad< Async< T> > -
Available on M, provided by the WrapOnMonadExt extension
-
wrapValueInAsync(
) → Result< Async< T> > -
Available on Result<
T> , provided by the WrapOnResultExt extension -
wrapValueInOk(
) → Monad< Ok< T> > -
Available on M, provided by the WrapOnMonadExt extension
-
wrapValueInOk(
) → Result< Ok< T> > -
Available on Result<
T> , provided by the WrapOnResultExt extension -
wrapValueInResolvable(
) → Monad< Resolvable< T> > -
Available on M, provided by the WrapOnMonadExt extension
-
wrapValueInResolvable(
) → Result< Resolvable< T> > -
Available on Result<
T> , provided by the WrapOnResultExt extension -
wrapValueInSome(
) → Monad< Some< T> > -
Available on M, provided by the WrapOnMonadExt extension
-
wrapValueInSome(
) → Result< Some< T> > -
Available on Result<
T> , provided by the WrapOnResultExt extension -
wrapValueInSync(
) → Monad< Sync< T> > -
Available on M, provided by the WrapOnMonadExt extension
-
wrapValueInSync(
) → Result< Sync< T> > -
Available on Result<
T> , provided by the WrapOnResultExt extension
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Methods
-
combine2<
T1 extends Object, T2 extends Object> (Result< T1> r1, Result<T2> r2, [Err<(T1, T2)> onErr(Result<T1> , Result<T2> )?]) → Result<(T1, T2)> - Combines 2 Result monads into 1 containing a tuple of their values if all are Ok.
-
combine3<
T1 extends Object, T2 extends Object, T3 extends Object> (Result< T1> r1, Result<T2> r2, Result<T3> r3, [Err<(T1, T2, T3)> onErr(Result<T1> , Result<T2> , Result<T3> )?]) → Result<(T1, T2, T3)> - Combines 3 Result monads into 1 containing a tuple of their values if all are Ok.