Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

MemoryExtensions.AsSpan a IndexOf: hledání v pohledu na text

Vytvoř pohled na text bez kopírování, vyhledej prvek nebo posloupnost a vypiš výřez pomocí `Console.Out.Write`, aniž by vznikl nový podřetězec.

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

Syntaxe

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 a IndexOf jsou zde statické rozšiřující metody třídy System.MemoryExtensions. S using System; odpovídá text.AsSpan() volání MemoryExtensions.AsSpan(text) a view.IndexOf('=') volání MemoryExtensions.IndexOf<char>(view, '='). Nejde o instanční metody typů string a ReadOnlySpan<char>. Naproti tomu string.IndexOf je samostatná instanční metoda, která hledá v samotném řetězci.

AsSpan() vrací ReadOnlySpan<char> nad celým řetězcem, AsSpan(start) pohled od start do konce a AsSpan(start, length) pohled dané délky od start. Pohled data nekopíruje ani přes něj nelze zapisovat. AsSpan() bez posunu vrací pro null prázdný pohled; neplatné meze u řetězce jiného než null vyvolají ArgumentOutOfRangeException. AsSpan<T>(T[]) naproti tomu vrací zapisovatelný Span<T> nad polem.

Generická přetížení IndexOf<T> hledají jeden prvek T nebo souvislou posloupnost ReadOnlySpan<T> a prvky porovnávají pomocí IEquatable<T>.Equals. Existují i přetížení volaná nad Span<T>. Pro posloupnost char lze zadat StringComparison: Ordinal rozlišuje velikost písmen a nezávisí na jazykovém nastavení. Výsledkem je index prvního výskytu počítaný od nuly vzhledem k pohledu nebo -1. Indexy v textu počítají kódové jednotky UTF-16, nikoli znaky vnímané čtenářem. Než výsledek použiješ k indexování nebo výřezu, ověř >= 0.

Slice je instanční metoda, která vrací užší pohled. Console.Out má typ System.IO.TextWriter, takže Console.Out.Write(view) volá jeho virtuální instanční metodu Write(ReadOnlySpan<char>) bez přidání konce řádku. Volající nemusí vytvářet podřetězec; to však nezaručuje, že zapisovač interně nealokuje paměť.

V C# 12 je ReadOnlySpan<T> typ ref struct: nelze ho uložit do pole třídy, boxovat ani deklarovat proměnnou tohoto typu v metodě async. Příklad je synchronní a cílí na .NET 8; pozdější verze běhového prostředí mohou přidávat kompatibilní funkce.

Příklady

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();
}

Výsledek

4 5 -1
ada

Pohled obsahuje `name=ada`: `=` je na indexu `4`, `ada` začíná na `5` a `:` je jen v přeskočené předponě, takže jeho hledání vrátí `-1`. `Slice(separator + 1)` vybere `ada` pro `Console.Out.Write`.

Související lekce

  • C# · Lekce 9 · Pokročilá · Verze: 3

Zdroje