Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

MemoryExtensions.AsSpan i IndexOf: pretraživanje pogleda na tekst

Stvori pogled na tekst bez kopiranja, pronađi element ili slijed pa ispiši odsječak pomoću `Console.Out.Write` bez stvaranja podniza.

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

Sintaksa

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 ovdje su statičke metode proširenja klase System.MemoryExtensions. Uz using System;, text.AsSpan() odgovara pozivu MemoryExtensions.AsSpan(text), a view.IndexOf('=') pozivu MemoryExtensions.IndexOf<char>(view, '='). To nisu metode instance tipova string odnosno ReadOnlySpan<char>. string.IndexOf zasebna je metoda instance koja pretražuje sam niz znakova.

AsSpan() vraća ReadOnlySpan<char> nad cijelim nizom znakova, AsSpan(start) pogled od start do kraja, a AsSpan(start, length) pogled zadane duljine od start. Pogled ne kopira podatke niti dopušta da ih mijenjaš preko njega. AsSpan() bez pomaka za null vraća prazan pogled; nevaljane granice kod niza koji nije null izazivaju ArgumentOutOfRangeException. Nasuprot tomu, AsSpan<T>(T[]) vraća Span<T> koji dopušta upis u polje.

Generička preopterećenja IndexOf<T> traže jedan element T ili neprekinuti slijed ReadOnlySpan<T> i uspoređuju elemente pomoću IEquatable<T>.Equals. Postoje i preopterećenja s primateljem Span<T>. Za slijed char možeš zadati StringComparison: Ordinal razlikuje velika i mala slova i ne ovisi o jezičnim postavkama. Rezultat je indeks prvog podudaranja, računat od nule u odnosu na pogled, ili -1. Indeksi teksta broje kodne jedinice UTF-16, a ne znakove kako ih čitatelj doživljava. Provjeri >= 0 prije uporabe rezultata za indeksiranje ili izdvajanje odsječka.

Slice je metoda instance koja vraća uži pogled. Console.Out ima tip System.IO.TextWriter, pa Console.Out.Write(view) poziva njegovu virtualnu metodu instance Write(ReadOnlySpan<char>) bez dodavanja kraja retka. Pozivatelj ne mora stvarati podniz; to ne jamči da objekt za pisanje interno ne alocira memoriju.

U C# 12 ReadOnlySpan<T> je tip ref struct: ne možeš ga spremiti u polje klase, primijeniti boxing ni deklarirati varijablu tog tipa u metodi async. Primjer je sinkron i cilja .NET 8; novija izvršna okruženja mogu dodati kompatibilne mogućnosti.

Primjeri

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

Rezultat

4 5 -1
ada

Pogled sadrži `name=ada`: `=` je na indeksu `4`, `ada` počinje na `5`, a `:` je samo u preskočenom prefiksu, pa ta pretraga vraća `-1`. `Slice(separator + 1)` odabire `ada` za `Console.Out.Write`.

Povezane lekcije

  • C# · Lekcija 9 · Napredno · Verzija: 3

Izvori