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
- MemoryExtensions.AsSpan Method (System)
- MemoryExtensions.IndexOf Method (System)
- MemoryExtensions.SequenceEqual Method (System)
- MemoryExtensions.Equals Method (System)
- ref struct types - C# reference
- ReadOnlySpan<T>.Equality(ReadOnlySpan<T>, ReadOnlySpan<T>) Operator (System)
- String.IndexOf Method (System)
- Enumerable.SequenceEqual Method (System.Linq)
- Int32.TryParse Method (System)
- Decimal.TryParse Method (System)
- CryptographicOperations.FixedTimeEquals Method (System.Security.Cryptography)