CKTIS / C#
Wyszukiwanie, porównywanie i parsowanie widoków span
Twórz widoki tekstu bez kopiowania, wyszukuj i porównuj ich zawartość oraz parsuj pola jako `int` lub `decimal` z jawnymi regułami formatu.
Wersja: C# 12 and .NET 8; later runtimes may add compatible features
Składnia
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);W C# 12 i .NET 8 metody rozszerzające System.MemoryExtensions udostępnia using System;. AsSpan() tworzy widok bez kopiowania: z string otrzymasz ReadOnlySpan<char>, a z tablicy T[] — zapisywalny Span<T>. Tablicowe przeciążenie AsSpan<T> zgłasza ArrayTypeMismatchException, gdy tablica jest przekazana kowariantnie, na przykład gdy string[] jest przekazana jako object[]. AsSpan(start, length) wybiera fragment; nieprawidłowe granice dla źródła innego niż null powodują ArgumentOutOfRangeException. AsSpan() bez argumentów na napisie null zwraca pusty widok. Oba typy span są ref struct: widok nie może przeżyć pamięci, na którą wskazuje, a w C# 12 nie można deklarować lokalnej zmiennej span w metodzie async ani w iteratorze.
IndexOf wyszukuje pojedynczy element albo ciąg kolejnych elementów. Zwraca indeks pierwszego trafienia, liczony od zera względem przeszukiwanego widoku, lub -1, jeśli nic nie znajdzie; pustego wzorca szuka z wynikiem 0. Sprawdź wynik przed wycięciem fragmentu. Pokazane przeciążenia generyczne korzystają z IEquatable<T>; dla char porównują jednostki kodowe UTF-16. To nie String.IndexOf: przeciążenie z string domyślnie uwzględnia bieżącą kulturę, a to z char działa porządkowo. Do wyszukiwania w widoku tekstu bez rozróżniania wielkości liter wybierz przeciążenie z StringComparison.OrdinalIgnoreCase.
SequenceEqual wymaga tej samej długości i równych elementów na odpowiadających sobie pozycjach. Dla widoków char pokazane wywołanie rozróżnia wielkość liter i nie normalizuje Unicode; do porównania bez rozróżniania wielkości liter użyj MemoryExtensions.Equals z StringComparison.OrdinalIgnoreCase. Operator == dla spanów sprawdza początek w pamięci i długość, nie zawartość. LINQ System.Linq.Enumerable.SequenceEqual działa na IEnumerable<T>, nie na spanach. Nie zakładaj stałego czasu dla SequenceEqual; do porównania tajnych danych bajtowych o tej samej długości użyj CryptographicOperations.FixedTimeEquals.
int.TryParse i decimal.TryParse przyjmują ReadOnlySpan<char> bez tworzenia podnapisu. Wybierz NumberStyles i kulturę zgodnie z formatem danych: tutaj NumberStyles.None nie włącza żadnych opcjonalnych elementów formatu, a NumberStyles.AllowDecimalPoint dopuszcza separator dziesiętny, którym w CultureInfo.InvariantCulture jest .. W .NET 8 obie metody ignorują końcowe znaki U+0000 nawet przy tych ustawieniach. Jeśli format ich zabrania, odrzuć je jawnie przed parsowaniem. Odczytuj out tylko po true; puste pole lub wartość spoza zakresu int przy parsowaniu liczby całkowitej daje false, ale nieprawidłowa wartość NumberStyles może spowodować wyjątek.
Przykłady
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}"));Wynik
count=42; price=19.95
Program sprawdza etykietę `item`, znajduje oba separatory i parsuje dwa pola bez tworzenia podnapisów. Pozycja średnika jest liczona od początku `fields`, nie `record`.
Powiązane lekcje
- C# · Lekcja 55 · Zaawansowany · Wersja: 3
Źródła
- 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)