Struct Result<T>

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

Implements

ISerializable

Namespace: DotNext

Assembly: DotNext.dll

Syntax

public struct Result<T> : ISerializable

Type Parameters

Name	Description
T

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

Methods

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

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

Declaration

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

Parameters

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

Returns

Type	Description
Result<U>	The conversion result.

Type Parameters

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

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

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

Declaration

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

Parameters

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

Returns

Type	Description
Result<U>	The conversion result.

Type Parameters

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

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(Func<T>)

Returns the value if present; otherwise invoke delegate.

Declaration

public T OrInvoke(Func<T> defaultFunc)

Parameters

Type	Name	Description
DotNext.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
DotNext.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.

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.

ToString()

Returns textual representation of this object.

Declaration

public override string ToString()

Returns

Type	Description
String	The textual representation of this object.

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(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>

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.

Implements

ISerializable

Extension Methods

ExpressionBuilder.Const<T>(T)

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