SpanOwner<T>

El SpanOwner<T> es un tipo de búfer de solo pila que alquila búferes de un grupo de memoria compartido. Básicamente refleja la funcionalidad de MemoryOwner<T>, pero como un tipo ref struct. Esto es especialmente útil para los búferes de corta duración que solo se usan en código sincrónico (que no requieren instancias de Memory<T> ), así como código que se ejecuta en un bucle ajustado, ya que la creación de valores SpanOwner<T> no requerirá asignaciones de memoria en absoluto.

API de la plataforma: SpanOwner<T>, MemoryOwner<T>

Sintaxis

Las mismas características principales de MemoryOwner<T>también se aplican a este tipo, a excepción de que sea structde solo pila, y el hecho de que carece de la implementación IMemoryOwner<T> interface, así como la propiedad Memory<T>. La sintaxis es prácticamente idéntica a la que se usa con MemoryOwner<T>, excepto las diferencias mencionadas anteriormente.

Por ejemplo, supongamos que tenemos un método en el que necesitamos asignar un búfer temporal de un tamaño especificado (vamos a llamar a este valor length) y, a continuación, usarlo para realizar algún trabajo. Una primera versión ineficaz podría tener este aspecto:

byte[] buffer = new byte[length];

// Use buffer here

Esto no es ideal, ya que asignamos un nuevo búfer cada vez que se usa este código y, a continuación, lo elimina inmediatamente (como se menciona en los documentos MemoryOwner<T> ), lo que pone más presión en el recolector de elementos no utilizados. Podemos optimizar el código anterior mediante ArrayPool<T>:

// Using directive to access the ArrayPool<T> type
using System.Buffers;

int[] buffer = ArrayPool<int>.Shared.Rent(length);

try
{
    // Slice the span, as it might be larger than the requested size
    Span<int> span = buffer.AsSpan(0, length);

    // Use the span here
}
finally
{
    ArrayPool<int>.Shared.Return(buffer);
}

El código anterior alquila un búfer de un grupo de matrices, pero es más detallado y propenso a errores: es necesario tener cuidado con el bloque try/finally para asegurarse de devolver siempre el búfer alquilado al grupo. Podemos volver a escribirlo mediante el tipo SpanOwner<T>, de la siguiente manera:

// Be sure to include this using at the top of the file:
using Microsoft.Toolkit.HighPerformance.Buffers;

using SpanOwner<int> buffer = SpanOwner<int>.Allocate(length);

Span<int> span = buffer.Span;

// Use the span here, no slicing necessary

La instancia SpanOwner<T> alquilará internamente una matriz y se encargará de devolverla al grupo cuando salga del ámbito. Ya no es necesario usar un bloque try/finally, ya que el compilador de C# lo agregará automáticamente al expandir esa instrucción using. Por lo tanto, el tipo SpanOwner<T> se puede ver como un contenedor ligero alrededor de las API ArrayPool<T>, lo que hace que sean más compactos y fáciles de usar, lo que reduce la cantidad de código que se debe escribir para alquilar y eliminar búferes de corta duración correctamente. Puede ver cómo el uso SpanOwner<T> hace que el código sea mucho más corto y sencillo.

Ejemplos

Encontrará más ejemplos en las pruebas unitarias.