CKTIS / C#
Span y Memory: vistas de búferes sin copiar
Span<T> y Memory<T> describen regiones de búferes existentes sin copiar sus elementos. Aprende sus restricciones de duración, sus variantes de solo lectura y el procesamiento de texto con AsSpan, IndexOf, SequenceEqual y TryParse.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
Span<T>; ReadOnlySpan<T>; Memory<T>; ReadOnlyMemory<T>; text.AsSpan(); span[start..end]; memory.Span; "text"u8Span<T> es una vista modificable de una región de memoria contigua, mientras que ReadOnlySpan<T> solo permite leer a través de la vista. Crear o recortar una vista no copia elementos. Un span es en sí un ref struct; sus datos pueden estar, por ejemplo, en una matriz del montón o en memoria de la pila. ReadOnly restringe el acceso a través de la vista, pero no garantiza que otra vía de acceso no pueda modificar el búfer.
Memory<T> y ReadOnlyMemory<T> se pueden almacenar en campos de clase y conservar tras un await; su propiedad .Span proporciona una vista para el procesamiento síncrono. No son propietarios del búfer: no uses una vista después de que el búfer se haya devuelto a un grupo o haya terminado el período de uso permitido. Un span no se puede capturar en una lambda ni almacenar en un campo de clase. Desde C# 13, se permiten spans locales en métodos async con restricciones; no pueden sobrevivir a un await. Antes de C# 13, estaban prohibidos en esos métodos.
MemoryExtensions.AsSpan crea una vista; para un string, devuelve un ReadOnlySpan<char> de unidades de código UTF-16. MemoryExtensions.IndexOf devuelve el primer índice de base cero o -1: comprueba el resultado antes de recortar. MemoryExtensions.SequenceEqual compara las longitudes y los elementos correspondientes, no la identidad de las vistas; para char, no realiza una comparación lingüística sensible a la cultura.
Int32.TryParse(ReadOnlySpan<char>, ...) y Decimal.TryParse(ReadOnlySpan<char>, ...) analizan un segmento sin crear una subcadena. Comprueba el bool devuelto; especifica NumberStyles y CultureInfo.InvariantCulture para obtener un formato predecible. Ambos métodos devuelven false si el texto numérico no es válido, pero los argumentos de estilo no válidos pueden provocar excepciones. Int32.TryParse también devuelve false para valores fuera del rango de Int32. En cambio, Decimal.TryParse puede redondear hacia abajo un valor ligeramente superior a decimal.MaxValue hasta decimal.MaxValue y devolver true. Esto ocurre, por ejemplo, con 79228162514264337593543950335.1 al usar NumberStyles.Number y CultureInfo.InvariantCulture.
Un literal de cadena UTF-8 con el sufijo u8, como "OK"u8, está disponible desde C# 11 y produce ReadOnlySpan<byte>, no string ni ReadOnlySpan<char>. Su longitud cuenta bytes, no caracteres. El ejemplo tiene como destino net10.0 con LangVersion=preview, pero utiliza características establecidas que no requieren el modo preview.
Identificadores de referencia incluidos en esta entrada: UTF-8 string literal u8.
Ejemplos
using System;
using System.Globalization;
ReadOnlyMemory<char> memory = "42;12.50".AsMemory();
ReadOnlySpan<char> text = memory.Span;
int separator = text.IndexOf(';');
if (separator < 0)
throw new FormatException("Missing separator.");
bool countOk = int.TryParse(text[..separator], NumberStyles.Integer,
CultureInfo.InvariantCulture, out int count);
bool priceOk = decimal.TryParse(text[(separator + 1)..], NumberStyles.Number,
CultureInfo.InvariantCulture, out decimal price);
if (!countOk || !priceOk)
throw new FormatException("Invalid number.");
Console.WriteLine(text[..separator].SequenceEqual("42".AsSpan()));
Console.WriteLine((count * price).ToString("F2", CultureInfo.InvariantCulture));
ReadOnlySpan<byte> command = "OK"u8;
Console.WriteLine(command.SequenceEqual("OK"u8));Resultado
True 525.00 True
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.
Fuentes
- C# language reference
- Memory<T> and Span<T> usage guidelines
- ref struct types - C# reference
- Introduction to character encoding in .NET
- MemoryExtensions.AsSpan Method (System)
- MemoryExtensions.IndexOf Method (System)
- MemoryExtensions.SequenceEqual Method (System)
- Int32.TryParse Method (System)
- Decimal.TryParse Method (System)
- Official reference — learn.microsoft.com: api / system.readonlyspan-1
- Official reference — learn.microsoft.com: api / system.memoryextensions