CKTIS / C#
MemoryExtensions.AsSpan a IndexOf: vyhľadávanie v pohľade na text
Vytvor pohľad na text bez kopírovania, vyhľadaj prvok alebo postupnosť a vypíš výrez pomocou `Console.Out.Write` bez vytvorenia podreťazca.
Verzia: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
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 sú tu statické rozširujúce metódy triedy System.MemoryExtensions. S using System; je text.AsSpan() ekvivalentom MemoryExtensions.AsSpan(text) a view.IndexOf('=') ekvivalentom MemoryExtensions.IndexOf<char>(view, '='). Nie sú to inštančné metódy typov string a ReadOnlySpan<char>. string.IndexOf je samostatná inštančná metóda, ktorá vyhľadáva v samotnom reťazci.
AsSpan() vracia ReadOnlySpan<char> nad celým reťazcom, AsSpan(start) pohľad od start do konca a AsSpan(start, length) pohľad zadanej dĺžky od start. Pohľad údaje nekopíruje a neumožňuje do nich zapisovať. AsSpan() bez posunu vracia pre null prázdny pohľad; neplatné hranice pri reťazci inom než null vyvolajú ArgumentOutOfRangeException. AsSpan<T>(T[]) naopak vracia zapisovateľný Span<T> nad poľom.
Generické preťaženia IndexOf<T> hľadajú jeden prvok T alebo súvislú postupnosť ReadOnlySpan<T> a porovnávajú prvky pomocou IEquatable<T>.Equals. Existujú aj preťaženia pre prijímač Span<T>. Pre postupnosť char možno zadať StringComparison: Ordinal rozlišuje veľké a malé písmená a nezávisí od jazykového nastavenia. Výsledkom je index prvého výskytu počítaný od nuly vzhľadom na pohľad alebo -1. Indexy textu počítajú kódové jednotky UTF-16, nie znaky vnímané čitateľom. Pred použitím výsledku na indexovanie alebo vytvorenie výrezu over >= 0.
Slice je inštančná metóda, ktorá vracia užší pohľad. Console.Out má typ System.IO.TextWriter, takže Console.Out.Write(view) volá jeho virtuálnu inštančnú metódu Write(ReadOnlySpan<char>) bez pridania konca riadka. Volajúci nemusí vytvárať podreťazec; to však nezaručuje, že zapisovač interne nealokuje pamäť.
V C# 12 je ReadOnlySpan<T> typ ref struct: nemožno ho uložiť do poľa triedy, boxovať ani deklarovať premennú tohto typu v metóde async. Príklad je synchrónny a cieli na .NET 8; novšie verzie behového prostredia môžu pridať kompatibilné funkcie.
Prí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ýsledok
4 5 -1 ada
Pohľad obsahuje `name=ada`: `=` je na indexe `4`, `ada` sa začína na `5` a `:` je len v preskočenej predpone, takže jeho hľadanie vráti `-1`. `Slice(separator + 1)` vyberie `ada` pre `Console.Out.Write`.
Súvisiace lekcie
- C# · Lekcia 9 · Pokročilá · Verzia: 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>)