CKTIS / C#
Span e Memory: viste sui buffer senza copie
Span<T> e Memory<T> descrivono regioni di buffer esistenti senza copiarne gli elementi. Scopri i vincoli di durata, le varianti di sola lettura e l’elaborazione del testo con AsSpan, IndexOf, SequenceEqual e TryParse.
Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintassi
Span<T>; ReadOnlySpan<T>; Memory<T>; ReadOnlyMemory<T>; text.AsSpan(); span[start..end]; memory.Span; "text"u8Span<T> è una vista scrivibile su una regione di memoria contigua, mentre ReadOnlySpan<T> consente soltanto la lettura tramite la vista. Creare o ritagliare una vista non copia gli elementi. Uno span è a sua volta un ref struct; i suoi dati possono trovarsi, per esempio, in un array nell’heap o nella memoria dello stack. ReadOnly limita l’accesso tramite la vista, ma non garantisce che il buffer non possa essere modificato attraverso un altro percorso di accesso.
Memory<T> e ReadOnlyMemory<T> possono essere memorizzati nei campi di una classe e mantenuti oltre un await; la proprietà .Span espone una vista per l’elaborazione sincrona. Non sono proprietari del buffer: non usare una vista dopo che il buffer è stato restituito a un pool o dopo la fine del periodo d’uso consentito. Uno span non può essere acquisito da una lambda né memorizzato in un campo di classe. Da C# 13, gli span locali sono consentiti nei metodi async con alcune limitazioni; non possono sopravvivere a un await. Prima di C# 13 erano vietati in questi metodi.
MemoryExtensions.AsSpan crea una vista; per una string, restituisce un ReadOnlySpan<char> di unità di codice UTF-16. MemoryExtensions.IndexOf restituisce il primo indice a base zero o -1: controlla il risultato prima di ritagliare. MemoryExtensions.SequenceEqual confronta le lunghezze e gli elementi corrispondenti, non l’identità delle viste; per char non esegue un confronto linguistico sensibile alle impostazioni cultura.
Int32.TryParse(ReadOnlySpan<char>, ...) e Decimal.TryParse(ReadOnlySpan<char>, ...) analizzano una porzione senza creare una sottostringa. Controlla il bool restituito; specifica NumberStyles e CultureInfo.InvariantCulture per un formato prevedibile. Entrambi i metodi restituiscono false se il testo numerico non è valido, ma argomenti di stile non validi possono causare eccezioni. Int32.TryParse restituisce false anche per valori al di fuori dell’intervallo di Int32. Decimal.TryParse, invece, può arrotondare per difetto un valore appena superiore a decimal.MaxValue, ottenendo decimal.MaxValue e restituendo true. Ciò accade, per esempio, con 79228162514264337593543950335.1 quando si usano NumberStyles.Number e CultureInfo.InvariantCulture.
Un literal di stringa UTF-8 con il suffisso u8, come "OK"u8, è disponibile da C# 11 e produce un ReadOnlySpan<byte>, non una string né un ReadOnlySpan<char>. La sua lunghezza conta i byte, non i caratteri. L’esempio è destinato a net10.0 con LangVersion=preview, ma usa funzionalità consolidate che non richiedono la modalità preview.
Identificatori di riferimento trattati in questa voce: UTF-8 string literal u8.
Esempi
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));Risultato
True 525.00 True
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.
Fonti
- 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