CKTIS / C#
Span et Memory : vues sur des buffers sans copie
Span<T> et Memory<T> décrivent des régions de buffers existants sans en copier les éléments. Découvrez leurs contraintes de durée de vie, leurs variantes en lecture seule et le traitement de texte avec AsSpan, IndexOf, SequenceEqual et TryParse.
Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
Span<T>; ReadOnlySpan<T>; Memory<T>; ReadOnlyMemory<T>; text.AsSpan(); span[start..end]; memory.Span; "text"u8Span<T> est une vue modifiable sur une région mémoire contiguë, tandis que ReadOnlySpan<T> n’autorise que la lecture via cette vue. Créer ou découper une vue ne copie pas les éléments. Un span est lui-même un ref struct ; ses données peuvent se trouver, par exemple, dans un tableau du tas ou dans la mémoire de la pile. ReadOnly limite l’accès via la vue, mais ne garantit pas qu’un autre moyen d’accès ne puisse pas modifier le buffer.
Memory<T> et ReadOnlyMemory<T> peuvent être stockés dans des champs de classe et conservés au-delà d’un await ; leur propriété .Span fournit une vue pour le traitement synchrone. Ils ne possèdent pas le buffer : n’utilisez pas une vue après que son buffer a été rendu à un pool ou que sa période d’utilisation autorisée a pris fin. Un span ne peut pas être capturé dans une lambda ni stocké dans un champ de classe. Depuis C# 13, les spans locaux sont autorisés dans les méthodes async, sous certaines contraintes ; ils ne peuvent pas survivre à un await. Avant C# 13, ils étaient interdits dans ces méthodes.
MemoryExtensions.AsSpan crée une vue ; pour un string, il renvoie un ReadOnlySpan<char> d’unités de code UTF-16. MemoryExtensions.IndexOf renvoie le premier index de base zéro ou -1 : vérifiez le résultat avant de découper. MemoryExtensions.SequenceEqual compare les longueurs et les éléments correspondants, pas l’identité des vues ; pour char, il n’effectue pas de comparaison linguistique sensible à la culture.
Int32.TryParse(ReadOnlySpan<char>, ...) et Decimal.TryParse(ReadOnlySpan<char>, ...) analysent une tranche sans créer de sous-chaîne. Vérifiez le bool renvoyé ; spécifiez NumberStyles et CultureInfo.InvariantCulture pour obtenir un format prévisible. Les deux méthodes renvoient false si le texte numérique est invalide, mais des arguments de style invalides peuvent provoquer des exceptions. Int32.TryParse renvoie également false pour les valeurs hors de la plage de Int32. En revanche, Decimal.TryParse peut arrondir une valeur légèrement supérieure à decimal.MaxValue à la valeur inférieure decimal.MaxValue et renvoyer true. C’est le cas, par exemple, pour 79228162514264337593543950335.1 avec NumberStyles.Number et CultureInfo.InvariantCulture.
Un littéral de chaîne UTF-8 avec le suffixe u8, comme "OK"u8, est disponible depuis C# 11 et produit un ReadOnlySpan<byte>, et non un string ou un ReadOnlySpan<char>. Sa longueur compte les octets, pas les caractères. L’exemple cible net10.0 avec LangVersion=preview, mais utilise des fonctionnalités établies qui ne nécessitent pas le mode preview.
Identifiants de référence couverts par cette entrée : UTF-8 string literal u8.
Exemples
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));Résultat
True 525.00 True
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.
Sources
- 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