WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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