WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Spans durchsuchen, vergleichen und als Zahlen einlesen

Durchsuche und vergleiche Textansichten ohne Kopie und lies Felder mit expliziten Formatregeln als `int` oder `decimal` ein.

Version: C# 12 and .NET 8; later runtimes may add compatible features

Syntax

using System;
using System.Globalization;

// Selected call forms for C# 12 / .NET 8:
ReadOnlySpan<char> text = sourceString.AsSpan();
ReadOnlySpan<char> part = sourceString.AsSpan(start, length);
Span<int> elements = sourceArray.AsSpan(); // sourceArray is int[]
int elementIndex = text.IndexOf(':');
int sequenceIndex = text.IndexOf(needle); // needle is ReadOnlySpan<char>
int textIndex = text.IndexOf(needle, StringComparison.OrdinalIgnoreCase);
bool same = text.SequenceEqual(needle);
bool sameIgnoringCase = MemoryExtensions.Equals(text, needle, StringComparison.OrdinalIgnoreCase);
bool intOk = int.TryParse(part, NumberStyles.None, CultureInfo.InvariantCulture, out int count);
bool decimalOk = decimal.TryParse(part, NumberStyles.AllowDecimalPoint, CultureInfo.InvariantCulture, out decimal price);

In C# 12 und .NET 8 stehen die Erweiterungsmethoden von System.MemoryExtensions mit using System; zur Verfügung. AsSpan() erstellt eine Ansicht ohne Kopie: aus string wird ein ReadOnlySpan<char>, aus T[] ein beschreibbarer Span<T>. Die Arrayüberladung AsSpan<T> löst bei kovarianter Übergabe eine ArrayTypeMismatchException aus, etwa wenn ein string[] als object[] übergeben wird. AsSpan(start, length) wählt einen Ausschnitt; bei einer Quelle ungleich null führen ungültige Grenzen zu ArgumentOutOfRangeException. Ohne Argumente ergibt ein null-String eine leere Ansicht. Beide Span-Typen sind ref struct: Die Ansicht darf den zugrunde liegenden Speicher nicht überleben. In C# 12 sind lokale Span-Variablen in asynchronen Methoden und Iteratoren nicht zulässig.

IndexOf sucht ein Element oder eine zusammenhängende Folge. Das Ergebnis ist der erste nullbasierte Index relativ zur durchsuchten Ansicht oder -1, wenn nichts gefunden wurde. Eine leere Suchfolge ergibt 0. Prüfe das Ergebnis vor dem Ausschneiden. Die gezeigten generischen Überladungen verwenden IEquatable<T>; bei char vergleichen sie UTF-16-Codeeinheiten. Anders bei String.IndexOf: Die string-Überladung verwendet standardmäßig die aktuelle Kultur, die char-Überladung sucht ordinal. Für die Suche im Text-Span ohne Beachtung der Groß- und Kleinschreibung nutze die Überladung mit StringComparison.OrdinalIgnoreCase.

SequenceEqual verlangt dieselbe Länge und gleiche Elemente an entsprechenden Positionen. Bei char-Spans unterscheidet der gezeigte Aufruf Groß- und Kleinschreibung und normalisiert Unicode nicht. Nutze MemoryExtensions.Equals mit StringComparison.OrdinalIgnoreCase, um die Schreibweise zu ignorieren. == prüft bei Spans Startadresse und Länge, nicht den Inhalt. LINQs System.Linq.Enumerable.SequenceEqual arbeitet mit IEnumerable<T>, nicht mit Spans. Verlass dich bei SequenceEqual nicht auf konstante Laufzeit; verwende für geheime Bytefolgen gleicher Länge CryptographicOperations.FixedTimeEquals.

int.TryParse und decimal.TryParse verarbeiten ReadOnlySpan<char> ohne Teilzeichenfolge. Wähle NumberStyles und Kultur passend zum Eingabeformat: NumberStyles.None aktiviert hier keine optionalen Formatelemente, NumberStyles.AllowDecimalPoint erlaubt das Dezimaltrennzeichen, also . bei CultureInfo.InvariantCulture. In .NET 8 ignorieren beide Methoden auch mit diesen Einstellungen abschließende U+0000-Zeichen. Wenn das Format sie verbietet, weise sie vor dem Einlesen ausdrücklich zurück. Verwende den out-Wert nur bei true. Ein leeres Feld oder ein Ganzzahlüberlauf ergibt false; ein ungültiger NumberStyles-Wert kann dagegen eine Ausnahme auslösen.

Beispiele

using System;
using System.Globalization;

ReadOnlySpan<char> record = "item:42;19.95".AsSpan();
int colon = record.IndexOf(":".AsSpan());
if (colon < 0 || !record[..colon].SequenceEqual("item".AsSpan()))
{
    Console.WriteLine("Invalid record.");
    return;
}

ReadOnlySpan<char> fields = record[(colon + 1)..];
int separator = fields.IndexOf(';');
var culture = CultureInfo.InvariantCulture;
if (separator < 0 ||
    !int.TryParse(fields[..separator], NumberStyles.None, culture, out int count) ||
    !decimal.TryParse(fields[(separator + 1)..], NumberStyles.AllowDecimalPoint, culture, out decimal price))
{
    Console.WriteLine("Invalid record.");
    return;
}

Console.WriteLine(FormattableString.Invariant($"count={count}; price={price:0.00}"));

Ergebnis

count=42; price=19.95

Das Programm prüft die Kennung `item`, findet beide Trennzeichen und liest zwei Felder ohne Teilzeichenfolgen ein. Der Semikolonindex bezieht sich auf `fields`, nicht auf `record`.

Zugehörige Lektionen

  • C# · Lektion 55 · Fortgeschritten · Version: 3

Quellen