CKTIS / C#
Span und Memory: Puffersichten ohne Kopieren
Span<T> und Memory<T> beschreiben Bereiche vorhandener Puffer, ohne deren Elemente zu kopieren. Lerne ihre Lebensdauerbeschränkungen, schreibgeschützte Varianten und die Textverarbeitung mit AsSpan, IndexOf, SequenceEqual und TryParse kennen.
Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
Span<T>; ReadOnlySpan<T>; Memory<T>; ReadOnlyMemory<T>; text.AsSpan(); span[start..end]; memory.Span; "text"u8Span<T> ist eine beschreibbare Sicht auf einen zusammenhängenden Speicherbereich, während ReadOnlySpan<T> über die Sicht nur das Lesen erlaubt. Beim Erstellen oder Ausschneiden einer Sicht werden keine Elemente kopiert. Ein Span selbst ist ein ref struct; seine Daten können sich zum Beispiel in einem Heap-Array oder im Stack-Speicher befinden. ReadOnly beschränkt den Zugriff über die Sicht, garantiert aber nicht, dass der Puffer nicht über einen anderen Zugriffsweg geändert wird.
Memory<T> und ReadOnlyMemory<T> können in Klassenfeldern gespeichert und über await hinweg behalten werden; ihre Eigenschaft .Span stellt eine Sicht für die synchrone Verarbeitung bereit. Sie besitzen den Puffer nicht: Verwende eine Sicht nicht mehr, nachdem der Puffer an einen Pool zurückgegeben wurde oder seine zulässige Nutzungsdauer abgelaufen ist. Ein Span kann weder in einer Lambda-Funktion erfasst noch in einem Klassenfeld gespeichert werden. Seit C# 13 sind lokale Spans in async-Methoden mit Einschränkungen zulässig; sie dürfen ein await nicht überdauern. Vor C# 13 waren sie in diesen Methoden verboten.
MemoryExtensions.AsSpan erstellt eine Sicht; bei einem string gibt es ein ReadOnlySpan<char> aus UTF-16-Codeeinheiten zurück. MemoryExtensions.IndexOf gibt den ersten nullbasierten Index oder -1 zurück: Prüfe das Ergebnis, bevor du einen Ausschnitt erstellst. MemoryExtensions.SequenceEqual vergleicht die Länge und die jeweils entsprechenden Elemente, nicht die Identität der Sichten; bei char führt es keinen kulturabhängigen sprachlichen Vergleich durch.
Int32.TryParse(ReadOnlySpan<char>, ...) und Decimal.TryParse(ReadOnlySpan<char>, ...) verarbeiten einen Ausschnitt, ohne eine Teilzeichenfolge zu erstellen. Prüfe den zurückgegebenen bool; gib für ein vorhersehbares Format NumberStyles und CultureInfo.InvariantCulture an. Beide Methoden geben bei ungültigem Zahlentext false zurück; ungültige Stilargumente können jedoch Ausnahmen auslösen. Int32.TryParse gibt auch bei Werten außerhalb des Wertebereichs von Int32 false zurück. Dagegen kann Decimal.TryParse einen Wert knapp oberhalb von decimal.MaxValue auf decimal.MaxValue abrunden und true zurückgeben. Das geschieht beispielsweise bei 79228162514264337593543950335.1 mit NumberStyles.Number und CultureInfo.InvariantCulture.
Ein UTF-8-Stringliteral mit dem Suffix u8, etwa "OK"u8, ist seit C# 11 verfügbar und ergibt ein ReadOnlySpan<byte>, kein string und kein ReadOnlySpan<char>. Seine Länge zählt Bytes, nicht Zeichen. Das Beispiel zielt auf net10.0 mit LangVersion=preview, verwendet aber etablierte Funktionen und keine Funktionen, die den Preview-Modus erfordern.
In diesem Eintrag behandelte Referenzbezeichner: UTF-8 string literal u8.
Beispiele
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));Ergebnis
True 525.00 True
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.
Quellen
- 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