Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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"u8

Span<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