Struct Result<T>

Represents a result of operation which can be actual result or exception.

Implements

ISerializable

Inherited Members

ValueType.Equals(Object)

ValueType.GetHashCode()

Object.Equals(Object, Object)

Object.GetType()

Object.ReferenceEquals(Object, Object)

Namespace: DotNext

Assembly: DotNext.dll

Syntax

[Serializable]
public struct Result<T> : ISerializable

Type Parameters

Name	Description
T	The type of the value stored in the Result monad.

Constructors

Result(T)

Initializes a new successful result.

Declaration

public Result(T value)

Parameters

Type	Name	Description
T	value	The value to be stored as result.

Result(Exception)

Initializes a new unsuccessful result.

Declaration

public Result(Exception error)

Parameters

Type	Name	Description
Exception	error	The exception representing error. Cannot be null.

Properties

Error

Gets exception associated with this result.

Declaration

public Exception Error { get; }

Property Value

Type	Description
Exception

IsSuccessful

Indicates that the result is successful.

Declaration

public bool IsSuccessful { get; }

Property Value

Type	Description
Boolean	true if this result is successful; false if this result represents exception.

Value

Extracts actual result.

Declaration

public T Value { get; }

Property Value

Type	Description
T

Exceptions

Type	Condition
Exception	This result is not successful.

Methods

Box()

Gets boxed representation of the result.

Declaration

public Result<object> Box()

Returns

Type	Description
Result<Object>	The boxed representation of the result.

Convert<TResult>(ValueFunc<T, TResult>)

If successful result is present, apply the provided mapping function hiding any exception caused by the converter.

Declaration

public Result<TResult> Convert<TResult>(in ValueFunc<T, TResult> converter)

Parameters

Type	Name	Description
ValueFunc<T, TResult>	converter	A mapping function to be applied to the value, if present.

Returns

Type	Description
Result<TResult>	The conversion result.

Type Parameters

Name	Description
TResult	The type of the result of the mapping function.

Convert<TResult>(Converter<T, TResult>)

If successful result is present, apply the provided mapping function hiding any exception caused by the converter.

Declaration

public Result<TResult> Convert<TResult>(Converter<T, TResult> converter)

Parameters

Type	Name	Description
Converter<T, TResult>	converter	A mapping function to be applied to the value, if present.

Returns

Type	Description
Result<TResult>	The conversion result.

Type Parameters

Name	Description
TResult	The type of the result of the mapping function.

FromOptional(Optional<T>)

Creates Result<T> from Optional<T> instance.

Declaration

public static Result<T> FromOptional(in Optional<T> optional)

Parameters

Type	Name	Description
Optional<T>	optional	The optional value.

Returns

Type	Description
Result<T>	The converted optional value.

Or(T)

Returns the value if present; otherwise return default value.

Declaration

public T Or(T defaultValue)

Parameters

Type	Name	Description
T	defaultValue	The value to be returned if this result is unsuccessful.

Returns

Type	Description
T	The value, if present, otherwise defaultValue.

OrDefault()

Returns the value if present; otherwise return default value.

Declaration

public T OrDefault()

Returns

Type	Description
T	The value, if present, otherwise default.

OrInvoke(ValueFunc<T>)

Returns the value if present; otherwise invoke delegate.

Declaration

public T OrInvoke(in ValueFunc<T> defaultFunc)

Parameters

Type	Name	Description
ValueFunc<T>	defaultFunc	A delegate to be invoked if value is not present.

Returns

Type	Description
T	The value, if present, otherwise returned from delegate.

OrInvoke(ValueFunc<Exception, T>)

Returns the value if present; otherwise invoke delegate.

Declaration

public T OrInvoke(in ValueFunc<Exception, T> defaultFunc)

Parameters

Type	Name	Description
ValueFunc<Exception, T>	defaultFunc	A delegate to be invoked if value is not present.

Returns

Type	Description
T	The value, if present, otherwise returned from delegate.

OrInvoke(Func<T>)

Returns the value if present; otherwise invoke delegate.

Declaration

public T OrInvoke(Func<T> defaultFunc)

Parameters

Type	Name	Description
Func<T>	defaultFunc	A delegate to be invoked if value is not present.

Returns

Type	Description
T	The value, if present, otherwise returned from delegate.

OrInvoke(Func<Exception, T>)

Returns the value if present; otherwise invoke delegate.

Declaration

public T OrInvoke(Func<Exception, T> defaultFunc)

Parameters

Type	Name	Description
Func<Exception, T>	defaultFunc	A delegate to be invoked if value is not present.

Returns

Type	Description
T	The value, if present, otherwise returned from delegate.

ToString()

Returns textual representation of this object.

Declaration

public override string ToString()

Returns

Type	Description
String	The textual representation of this object.

Overrides

ValueType.ToString()

TryGet()

Converts the result into Optional<T>.

Declaration

public Optional<T> TryGet()

Returns

Type	Description
Optional<T>	Option monad representing value in this monad.

TryGet(out T)

Attempts to extract value from container if it is present.

Declaration

public bool TryGet(out T value)

Parameters

Type	Name	Description
T	value	Extracted value.

Returns

Type	Description
Boolean	true if value is present; otherwise, false.

Operators

BitwiseAnd(Result<T>, Result<T>)

Indicates that both results are successful.

Declaration

public static bool operator &(in Result<T> left, in Result<T> right)

Parameters

Type	Name	Description
Result<T>	left	The first result to check.
Result<T>	right	The second result to check.

Returns

Type	Description
Boolean	true if both results are successful; otherwise, false.

Explicit(Optional<T> to Result<T>)

Converts Optional<T> to Result<T>.

Declaration

public static explicit operator Result<T>(in Optional<T> optional)

Parameters

Type	Name	Description
Optional<T>	optional	The optional value.

Returns

Type	Description
Result<T>	The result representing optional value.

Explicit(Result<T> to T)

Extracts actual result.

Declaration

public static explicit operator T(in Result<T> result)

Parameters

Type	Name	Description
Result<T>	result	The result object.

Returns

Type	Description
T

False(Result<T>)

Indicates that the result represents error.

Declaration

public static bool operator false (in Result<T> result)

Parameters

Type	Name	Description
Result<T>	result	The result to check.

Returns

Type	Description
Boolean	false if this result is successful; true if this result represents exception.

Implicit(T to Result<T>)

Converts value into the result.

Declaration

public static implicit operator Result<T>(T result)

Parameters

Type	Name	Description
T	result	The result to be converted.

Returns

Type	Description
Result<T>	The result representing result value.

Implicit(Result<T> to Optional<T>)

Converts the result into Optional<T>.

Declaration

public static implicit operator Optional<T>(in Result<T> result)

Parameters

Type	Name	Description
Result<T>	result	The result to be converted.

Returns

Type	Description
Optional<T>

True(Result<T>)

Indicates that the result is successful.

Declaration

public static bool operator true (in Result<T> result)

Parameters

Type	Name	Description
Result<T>	result	The result to check.

Returns

Type	Description
Boolean	true if this result is successful; false if this result represents exception.

Explicit Interface Implementations

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Declaration

void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context)

Parameters

Type	Name	Description
SerializationInfo	info
StreamingContext	context

Implements

System.Runtime.Serialization.ISerializable

Extension Methods

Result.Coalesce<T>(Result<T>, Result<T>)

Sequence.Skip<TEnumerator, T>(ref TEnumerator, Int32)

ExpressionBuilder.Const<T>(T)