CKTIS / C#
MemoryExtensions.AsSpan in IndexOf: iskanje v pogledu na besedilo
Ustvari pogled na besedilo brez kopiranja, poišči element ali zaporedje in izpiši izsek z `Console.Out.Write`, ne da bi ustvaril podniz.
Različica: 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 in IndexOf sta tu statični razširitveni metodi razreda System.MemoryExtensions. Z using System; je text.AsSpan() enakovreden klicu MemoryExtensions.AsSpan(text), view.IndexOf('=') pa klicu MemoryExtensions.IndexOf<char>(view, '='). To nista metodi primerka tipov string oziroma ReadOnlySpan<char>. string.IndexOf je ločena metoda primerka, ki išče v samem nizu.
AsSpan() vrne ReadOnlySpan<char> nad celotnim nizom, AsSpan(start) pogled od start do konca, AsSpan(start, length) pa pogled določene dolžine od start. Pogled podatkov ne kopira in ne omogoča njihovega spreminjanja. AsSpan() brez odmika za null vrne prazen pogled; neveljavne meje pri nizu, ki ni null, sprožijo ArgumentOutOfRangeException. Nasprotno AsSpan<T>(T[]) vrne Span<T>, prek katerega je mogoče pisati v polje.
Generične preobremenitve IndexOf<T> iščejo en element T ali strnjeno zaporedje ReadOnlySpan<T> in primerjajo elemente z IEquatable<T>.Equals. Obstajajo tudi preobremenitve s sprejemnikom Span<T>. Za zaporedje char lahko določiš StringComparison: Ordinal razlikuje velike in male črke ter ni odvisen od jezikovnih nastavitev. Rezultat je indeks prvega zadetka, štet od nič glede na začetek pogleda, ali -1. Indeksi besedila štejejo kodne enote UTF-16, ne znakov, kot jih zazna bralec. Pred indeksiranjem ali izrezovanjem preveri >= 0.
Slice je metoda primerka, ki vrne ožji pogled. Console.Out je tipa System.IO.TextWriter, zato Console.Out.Write(view) pokliče njegovo navidezno metodo primerka Write(ReadOnlySpan<char>) brez dodajanja konca vrstice. Klicatelju ni treba ustvariti podniza; to pa ne zagotavlja, da zapisovalnik interno ne dodeljuje pomnilnika.
V C# 12 je ReadOnlySpan<T> tip ref struct: ni ga mogoče shraniti v polje razreda, ga zapakirati z operacijo boxing ali deklarirati spremenljivke tega tipa v metodi async. Primer je sinhron in cilja na .NET 8; poznejša izvajalna okolja lahko dodajo združljive funkcije.
Primeri
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 vsebuje `name=ada`: `=` je na indeksu `4`, `ada` se začne na `5`, `:` pa je le v preskočeni predponi, zato to iskanje vrne `-1`. `Slice(separator + 1)` izbere `ada` za `Console.Out.Write`.
Povezane lekcije
- C# · Lekcija 9 · Napredna · Različica: 3
Viri
- 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>)