Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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