Struct ReadOnlyValueReference<T>

Represents an immutable reference to the field.

Implements

IEquatable<ReadOnlyValueReference<T>>

IEqualityOperators<ReadOnlyValueReference<T>, ReadOnlyValueReference<T>, bool>

ISupplier<T>

IFunctional<Func<T>>

Inherited Members

object.Equals(object, object)

object.GetType()

object.ReferenceEquals(object, object)

Namespace: DotNext.Runtime

Assembly: DotNext.dll

Syntax

public readonly struct ReadOnlyValueReference<T> : IEquatable<ReadOnlyValueReference<T>>, IEqualityOperators<ReadOnlyValueReference<T>, ReadOnlyValueReference<T>, bool>, ISupplier<T>, IFunctional<Func<T>>

Type Parameters

Name	Description
T	The type of the field.

Constructors

ReadOnlyValueReference(object, ref readonly T)

Represents an immutable reference to the field.

Declaration

public ReadOnlyValueReference(object owner, ref readonly T fieldRef)

Parameters

Type	Name	Description
object	owner	An object that owns the field.
T	fieldRef	The reference to the field.

ReadOnlyValueReference(ref readonly T)

Creates a reference to a static field.

Declaration

public ReadOnlyValueReference(ref readonly T staticFieldRef)

Parameters

Type	Name	Description
T	staticFieldRef	A reference to the static field.

Remarks

If T is a value type then your static field MUST be marked with FixedAddressValueTypeAttribute. Otherwise, the behavior is unpredictable. Correctness of this constructor is based on the fact that static fields are stored as elements of object array allocated by the runtime in the Pinned Object Heap. It means that the address of the field cannot be changed by GC.

See Also

Internals of the POH

ReadOnlyValueReference(T[], int)

Creates a reference to an array element.

Declaration

public ReadOnlyValueReference(T[] array, int index)

Parameters

Type	Name	Description
T[]	array	The array.
int	index	The index of the array element.

Properties

IsEmpty

Gets a value indicating that is reference is empty.

Declaration

public bool IsEmpty { get; }

Property Value

Type	Description
bool

Value

Gets a reference to the field.

Declaration

public ref readonly T Value { get; }

Property Value

Type	Description
T

Methods

Equals(ReadOnlyValueReference<T>)

Indicates whether the current object is equal to another object of the same type.

Declaration

public bool Equals(ReadOnlyValueReference<T> reference)

Parameters

Type	Name	Description
ReadOnlyValueReference<T>	reference

Returns

Type	Description
bool	true if the current object is equal to the other parameter; otherwise, false.

Equals(object?)

Indicates whether this instance and a specified object are equal.

Declaration

public override bool Equals(object? other)

Parameters

Type	Name	Description
object	other

Returns

Type	Description
bool	true if obj and this instance are the same type and represent the same value; otherwise, false.

Overrides

ValueType.Equals(object)

GetHashCode()

Returns the hash code for this instance.

Declaration

public override int GetHashCode()

Returns

Type	Description
int	A 32-bit signed integer that is the hash code for this instance.

Overrides

ValueType.GetHashCode()

ToString()

Returns the fully qualified type name of this instance.

Declaration

public override string? ToString()

Returns

Type	Description
string	The fully qualified type name.

Overrides

ValueType.ToString()

Operators

operator ==(ReadOnlyValueReference<T>, ReadOnlyValueReference<T>)

Determines whether the two references point to the same field.

Declaration

public static bool operator ==(ReadOnlyValueReference<T> x, ReadOnlyValueReference<T> y)

Parameters

Type	Name	Description
ReadOnlyValueReference<T>	x	The first reference to compare.
ReadOnlyValueReference<T>	y	The second reference to compare.

Returns

Type	Description
bool	true if both references are equal; otherwise, false.

explicit operator Func<T>(ReadOnlyValueReference<T>)

Returns a getter for the memory location.

Declaration

public static explicit operator Func<T>(ReadOnlyValueReference<T> reference)

Parameters

Type	Name	Description
ReadOnlyValueReference<T>	reference	A reference to a value.

Returns

Type	Description
Func<T>	A getter for the memory location.

implicit operator ReadOnlySpan<T>(ReadOnlyValueReference<T>)

Gets a span over the referenced value.

Declaration

public static implicit operator ReadOnlySpan<T>(ReadOnlyValueReference<T> reference)

Parameters

Type	Name	Description
ReadOnlyValueReference<T>	reference	The value reference.

Returns

Type	Description
ReadOnlySpan<T>	The span that contains Value; or empty span if reference is empty.

operator !=(ReadOnlyValueReference<T>, ReadOnlyValueReference<T>)

Determines whether the two references point to the different fields.

Declaration

public static bool operator !=(ReadOnlyValueReference<T> x, ReadOnlyValueReference<T> y)

Parameters

Type	Name	Description
ReadOnlyValueReference<T>	x	The first reference to compare.
ReadOnlyValueReference<T>	y	The second reference to compare.

Returns

Type	Description
bool	true if both references are not equal; otherwise, false.

Implements

IEquatable<T>

IEqualityOperators<TSelf, TOther, TResult>

ISupplier<TResult>

IFunctional<TDelegate>

Extension Methods

BasicExtensions.IsBetween<T, TLowerBound, TUpperBound>(T, TLowerBound, TUpperBound)

BasicExtensions.IsOneOf<T>(T, ReadOnlySpan<T>)

Collection.ToAsyncEnumerator<TEnumerator, T>(TEnumerator, CancellationToken)

Collection.ToClassicEnumerator<TEnumerator, T>(TEnumerator)

Enumerator.Skip<TEnumerator, T>(ref TEnumerator, int)

ExpressionBuilder.Const<T>(T)