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