CKTIS / C#
Span e Memory: vistas de buffers sem cópias
Span<T> e Memory<T> descrevem regiões de buffers existentes sem copiar os respetivos elementos. Conheça as restrições de duração, as variantes só de leitura e o processamento de texto com AsSpan, IndexOf, SequenceEqual e TryParse.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
Span<T>; ReadOnlySpan<T>; Memory<T>; ReadOnlyMemory<T>; text.AsSpan(); span[start..end]; memory.Span; "text"u8Span<T> é uma vista gravável sobre uma região contígua de memória, enquanto ReadOnlySpan<T> permite apenas a leitura através da vista. Criar ou recortar uma vista não copia elementos. Um span é, por si só, um ref struct; os seus dados podem estar, por exemplo, num array na heap ou na memória da stack. ReadOnly restringe o acesso através da vista, mas não garante que o buffer não possa ser alterado por outra via de acesso.
Memory<T> e ReadOnlyMemory<T> podem ser armazenados em campos de classes e mantidos para além de um await; a propriedade .Span disponibiliza uma vista para processamento síncrono. Não são proprietários do buffer: não utilize uma vista depois de o buffer ser devolvido a um pool ou de terminar o período de utilização permitido. Um span não pode ser capturado numa lambda nem armazenado num campo de classe. Desde C# 13, os spans locais são permitidos em métodos async, com restrições; não podem sobreviver a um await. Antes de C# 13, eram proibidos nestes métodos.
MemoryExtensions.AsSpan cria uma vista; para uma string, devolve um ReadOnlySpan<char> de unidades de código UTF-16. MemoryExtensions.IndexOf devolve o primeiro índice baseado em zero ou -1: verifique o resultado antes de recortar. MemoryExtensions.SequenceEqual compara os comprimentos e os elementos correspondentes, não a identidade das vistas; para char, não efetua uma comparação linguística sensível à cultura.
Int32.TryParse(ReadOnlySpan<char>, ...) e Decimal.TryParse(ReadOnlySpan<char>, ...) analisam um segmento sem criar uma substring. Verifique o bool devolvido; indique NumberStyles e CultureInfo.InvariantCulture para obter um formato previsível. Ambos os métodos devolvem false se o texto numérico for inválido, mas argumentos de estilo inválidos podem causar exceções. Int32.TryParse também devolve false para valores fora do intervalo de Int32. Já Decimal.TryParse pode arredondar um valor ligeiramente superior a decimal.MaxValue por defeito para decimal.MaxValue e devolver true. É o que acontece, por exemplo, com 79228162514264337593543950335.1 ao utilizar NumberStyles.Number e CultureInfo.InvariantCulture.
Um literal de cadeia UTF-8 com o sufixo u8, como "OK"u8, está disponível desde C# 11 e produz um ReadOnlySpan<byte>, não uma string nem um ReadOnlySpan<char>. O seu comprimento conta bytes, não caracteres. O exemplo tem como destino net10.0 com LangVersion=preview, mas utiliza funcionalidades estabelecidas que não requerem o modo preview.
Identificadores de referência abrangidos por esta entrada: UTF-8 string literal u8.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.
Fontes
- 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