Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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