CKTIS / C#
MemoryExtensions.AsSpan und IndexOf: in einer Textansicht suchen
Erstelle eine Textansicht ohne Kopie, suche nach einem Element oder einer Folge und gib den Ausschnitt mit `Console.Out.Write` ohne neuen Teilstring aus.
Version: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
using System;
// Selected .NET 8 signatures, declared in System.MemoryExtensions:
public static ReadOnlySpan<char> AsSpan(this string? text);
public static ReadOnlySpan<char> AsSpan(this string? text, int start);
public static ReadOnlySpan<char> AsSpan(this string? text, int start, int length);
public static Span<T> AsSpan<T>(this T[]? array);
public static int IndexOf<T>(this ReadOnlySpan<T> span, T value) where T : IEquatable<T>?;
public static int IndexOf<T>(this ReadOnlySpan<T> span, ReadOnlySpan<T> value) where T : IEquatable<T>?;
public static int IndexOf(this ReadOnlySpan<char> span, ReadOnlySpan<char> value, StringComparison comparisonType);
// Equivalent calls when the extension methods are in scope:
ReadOnlySpan<char> view = text.AsSpan(start, length);
ReadOnlySpan<char> sameView = System.MemoryExtensions.AsSpan(text, start, length);
int index = view.IndexOf('=');
int sameIndex = System.MemoryExtensions.IndexOf<char>(view, '=');
// Output uses a virtual instance method on System.IO.TextWriter:
Console.Out.Write(view);AsSpan und IndexOf sind hier statische Erweiterungsmethoden von System.MemoryExtensions. Mit using System; steht text.AsSpan() für MemoryExtensions.AsSpan(text) und view.IndexOf('=') für MemoryExtensions.IndexOf<char>(view, '='). Das sind keine Instanzmethoden von string bzw. ReadOnlySpan<char>. string.IndexOf ist eine eigene Instanzmethode, die in der Zeichenfolge selbst sucht.
AsSpan() liefert einen ReadOnlySpan<char> für die gesamte Zeichenfolge, AsSpan(start) eine Ansicht von start bis zum Ende und AsSpan(start, length) eine Ansicht der angegebenen Länge ab start. Die Ansicht kopiert keine Daten und erlaubt keinen schreibenden Zugriff. AsSpan() ohne Startindex liefert für null eine leere Ansicht. Ungültige Grenzen bei einer nicht-null Zeichenfolge lösen ArgumentOutOfRangeException aus. AsSpan<T>(T[]) liefert dagegen einen beschreibbaren Span<T> für das Array.
Die generischen Überladungen von IndexOf<T> suchen ein einzelnes T oder eine zusammenhängende ReadOnlySpan<T>-Folge. Elemente werden mit IEquatable<T>.Equals verglichen. Es gibt auch Überladungen für einen Span<T> als Empfänger. Bei einer char-Folge lässt sich StringComparison angeben: Ordinal beachtet Groß- und Kleinschreibung und ist kulturunabhängig. Das Ergebnis ist der nullbasierte Index des ersten Treffers relativ zur Ansicht oder -1. Textindizes zählen UTF-16-Codeeinheiten, nicht wahrgenommene Zeichen. Prüfe vor dem Indizieren oder Ausschneiden auf >= 0.
Slice ist eine Instanzmethode und liefert eine kleinere Ansicht. Console.Out ist ein System.IO.TextWriter. Console.Out.Write(view) ruft dessen virtuelle Instanzmethode Write(ReadOnlySpan<char>) auf und fügt keinen Zeilenumbruch an. Der Aufrufer braucht keinen Teilstring zu erzeugen; das schließt interne Speicherallokationen des Writers nicht aus.
In C# 12 ist ReadOnlySpan<T> ein ref struct: Er darf nicht als Klassenfeld gespeichert, geboxt oder als Variable in einer async-Methode deklariert werden. Das Beispiel läuft synchron und zielt auf .NET 8; spätere Laufzeitversionen können kompatible Funktionen ergänzen.
Beispiele
using System;
const string input = "log:name=ada";
ReadOnlySpan<char> field = input.AsSpan(4, 8);
int separator = field.IndexOf('=');
int name = MemoryExtensions.IndexOf(field, "ada".AsSpan(), StringComparison.Ordinal);
int missing = field.IndexOf(':');
Console.WriteLine(FormattableString.Invariant($"{separator} {name} {missing}"));
if (separator >= 0)
{
ReadOnlySpan<char> value = field.Slice(separator + 1);
Console.Out.Write(value);
Console.Out.WriteLine();
}Ergebnis
4 5 -1 ada
Die Ansicht enthält `name=ada`: `=` steht an Index `4`, `ada` beginnt bei `5` und `:` steht nur im übersprungenen Präfix. Die letzte Suche liefert deshalb `-1`. `Slice(separator + 1)` wählt `ada` für `Console.Out.Write` aus.
Zugehörige Lektionen
- C# · Lektion 9 · Fortgeschritten · Version: 3
Quellen
- MemoryExtensions.AsSpan Method (System)
- MemoryExtensions.IndexOf Method (System)
- Extension members (C# Programming Guide)
- String.IndexOf Method (System)
- ReadOnlySpan<T>.Slice Method (System)
- ref structure types (C# reference)
- Introduction to character encoding in .NET
- Best practices for comparing strings in .NET
- Console.Out Property (System)
- TextWriter.Write Method (System.IO) — Write(ReadOnlySpan<Char>)