CKTIS / C#
MemoryExtensions.AsSpan i IndexOf: wyszukiwanie w widoku tekstu
Utwórz widok tekstu bez kopiowania, wyszukaj element lub sekwencję, a znaleziony fragment wypisz przez `Console.Out.Write` bez tworzenia podciągu.
Wersja: C# 12 and .NET 8; later runtimes may add compatible features
Składnia
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 i IndexOf w tym zastosowaniu to statyczne metody rozszerzające klasy System.MemoryExtensions. Dyrektywa using System; udostępnia składnię rozszerzeń: text.AsSpan() oznacza MemoryExtensions.AsSpan(text), a view.IndexOf('=') oznacza MemoryExtensions.IndexOf<char>(view, '='). Nie są to metody instancyjne odpowiednio string i ReadOnlySpan<char>; string.IndexOf to odrębna metoda instancyjna, która szuka w samym łańcuchu.
AsSpan() zwraca ReadOnlySpan<char> obejmujący cały tekst, AsSpan(start) — od start do końca, a AsSpan(start, length) — widok o podanej długości od indeksu start. Nie kopiuje danych i nie pozwala zapisywać przez widok. AsSpan() dla null zwraca pusty widok; nieprawidłowe granice dla tekstu innego niż null powodują ArgumentOutOfRangeException. Przeciążenie AsSpan<T>(T[]) zwraca natomiast zapisywalny Span<T> nad tablicą.
Generyczne przeciążenia IndexOf<T> szukają jednego elementu T albo ciągłej sekwencji ReadOnlySpan<T>, porównując elementy przez IEquatable<T>.Equals; są też odpowiedniki dla odbiorcy Span<T>. Wyszukiwanie sekwencji char może jawnie przyjąć StringComparison; Ordinal uwzględnia wielkość liter i nie zależy od kultury. Wynik to indeks pierwszego dopasowania liczony od zera względem początku widoku albo -1. Dla tekstu indeks liczy jednostki kodowe UTF-16, nie znaki postrzegane przez użytkownika. Sprawdź >= 0, zanim użyjesz wyniku do indeksowania lub wycięcia fragmentu.
Slice to metoda instancyjna zwracająca węższy widok. Console.Out ma typ System.IO.TextWriter, więc Console.Out.Write(view) wywołuje wirtualną metodę instancyjną Write(ReadOnlySpan<char>) bez dopisywania końca wiersza. Kod wywołujący nie musi tworzyć podciągu; nie jest to gwarancja braku alokacji wewnątrz obiektu zapisującego.
W C# 12 ReadOnlySpan<T> jest typem ref struct: nie można go umieścić w polu klasy, opakować przez boxing ani zadeklarować zmiennej tego typu w metodzie async. Przykład jest synchroniczny i celuje w .NET 8; późniejsze wersje środowiska uruchomieniowego mogą dodawać zgodne funkcje.
Przykłady
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();
}Wynik
4 5 -1 ada
Widok zawiera `name=ada`: `=` ma indeks `4`, `ada` zaczyna się od `5`, a `:` występuje tylko w pominiętym prefiksie, więc wyszukiwanie zwraca `-1`. `Slice(separator + 1)` wybiera `ada`, które zapisuje `Console.Out.Write`.
Powiązane lekcje
- C# · Lekcja 9 · Zaawansowany · Wersja: 3
Źródła
- 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>)