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
- 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>)