Struct MemoryPoolToken<T>

Namespace

LfrlAnvil.Memory

Assembly

LfrlAnvil.Core.dll

A lightweight container for an underlying MemoryPool<T> node.

public readonly struct MemoryPoolToken<T> : IDisposable

Type Parameters

T

Element type.

Implements

IDisposable

Inherited Members

ValueType.Equals(object)

ValueType.GetHashCode()

object.Equals(object, object)

object.GetType()

object.ReferenceEquals(object, object)

Extension Methods

ObjectExtensions.Memoize<T1, T2>(T1, Func<T1, IEnumerable<T2>>)

ObjectExtensions.ToNullable<T>(T)

ObjectExtensions.ToRef<T>(T)

ObjectExtensions.VisitManyWithSelf<T>(T, Func<T, IEnumerable<T>>)

ObjectExtensions.VisitManyWithSelf<T>(T, Func<T, IEnumerable<T>>, Func<T, bool>)

ObjectExtensions.VisitMany<T>(T, Func<T, IEnumerable<T>>)

ObjectExtensions.VisitMany<T>(T, Func<T, IEnumerable<T>>, Func<T, bool>)

ObjectExtensions.VisitWithSelf<T>(T, Func<T, T>, Func<T, bool>)

ObjectExtensions.Visit<T>(T, Func<T, T>, Func<T, bool>)

Properties

Clear

Specifies whether or not the underlying buffer will be additionally cleared during this token's disposal.

public bool Clear { get; }

Property Value

bool

Empty

An empty sequence.

public static MemoryPoolToken<T> Empty { get; }

Property Value

MemoryPoolToken<T>

Owner

MemoryPool<T> instance that owns this token.

public MemoryPool<T>? Owner { get; }

Property Value

MemoryPool<T>

Methods

AsMemory()

Creates a new Memory<T> instance from the underlying buffer of this token.

[Pure]
public Memory<T> AsMemory()

Returns

Memory<T>

New Memory<T> instance.

Remarks

Returns an Empty instance for disposed tokens.

AsSpan()

Creates a new Span<T> instance from the underlying buffer of this token.

[Pure]
public Span<T> AsSpan()

Returns

Span<T>

New Span<T> instance.

Remarks

Returns an Empty instance for disposed tokens.

Dispose()

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

public void Dispose()

Remarks

Frees the underlying node and returns it to the pool.

EnableClearing(bool)

Creates a new MemoryPoolToken<T> from this token with a new Clear value.

[Pure]
public MemoryPoolToken<T> EnableClearing(bool enabled = true)

Parameters

enabled bool

Clear value to set.

Returns

MemoryPoolToken<T>

New MemoryPoolToken<T> instance.

SetLength(int)

Resizes the underlying buffer. Length change will invalidate exposed underlying buffer's Memory<T> or Span<T> instances.

public void SetLength(int length)

Parameters

length int

New underlying buffer length.

Remarks

When new length is less than the current length, then elements at the end of the buffer will be discarded. Additionally, the Clear value will determine whether or not discarded elements will be cleared.

Exceptions

ArgumentOutOfRangeException

When length is less than or equal to 0.

ToString()

Returns a string representation of this MemoryPoolToken<T> instance.

[Pure]
public override string ToString()

Returns

string

String representation.

TryGetInfo()

Returns a MemoryPool<T>.ReportInfo.Node instance that represents this token, if node exists.

[Pure]
public MemoryPool<T>.ReportInfo.Node? TryGetInfo()

Returns

MemoryPool<T>.ReportInfo.Node?

New MemoryPool<T>.ReportInfo.Node instance or null, if node does not exist.