Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

MemoryExtensions.AsSpan e IndexOf: cercare in una vista del testo

Crea una vista del testo senza copiarlo, cerca un elemento o una sequenza e scrivi il frammento con `Console.Out.Write` senza creare una sottostringa.

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

Sintassi

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 e IndexOf sono qui metodi di estensione statici di System.MemoryExtensions. Con using System;, text.AsSpan() equivale a MemoryExtensions.AsSpan(text) e view.IndexOf('=') a MemoryExtensions.IndexOf<char>(view, '='). Non sono metodi di istanza di string e ReadOnlySpan<char>, rispettivamente. string.IndexOf è un metodo di istanza distinto che cerca nella stringa stessa.

AsSpan() restituisce un ReadOnlySpan<char> sull’intera stringa, AsSpan(start) una vista da start alla fine e AsSpan(start, length) una vista della lunghezza indicata a partire da start. La vista non copia i dati e non consente di modificarli. AsSpan() senza offset restituisce una vista vuota per null; limiti non validi su una stringa non nulla causano ArgumentOutOfRangeException. AsSpan<T>(T[]) restituisce invece uno Span<T> scrivibile sull’array.

Gli overload generici di IndexOf<T> cercano un elemento T o una sequenza contigua ReadOnlySpan<T>, confrontando gli elementi con IEquatable<T>.Equals. Esistono anche overload con ricevitore Span<T>. Per una sequenza di char si può indicare StringComparison: Ordinal distingue maiuscole e minuscole e non dipende dalle impostazioni locali. Il risultato è l’indice della prima corrispondenza, a partire da zero rispetto alla vista, oppure -1. Gli indici del testo contano unità di codice UTF-16, non i caratteri percepiti. Controlla >= 0 prima di usare il risultato come indice o per ricavare una porzione.

Slice è un metodo di istanza che restituisce una vista più ristretta. Console.Out è un System.IO.TextWriter, quindi Console.Out.Write(view) chiama il suo metodo di istanza virtuale Write(ReadOnlySpan<char>) senza andare a capo. Il chiamante non deve creare una sottostringa; questo non garantisce che l’oggetto di scrittura non allochi memoria internamente.

In C# 12, ReadOnlySpan<T> è un ref struct: non si può memorizzare in un campo di classe, sottoporre a boxing o dichiarare come variabile in un metodo async. L’esempio è sincrono e usa come destinazione .NET 8; i runtime successivi possono aggiungere funzionalità compatibili.

Esempi

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

Risultato

4 5 -1
ada

La vista contiene `name=ada`: `=` è all’indice `4`, `ada` inizia a `5` e `:` appare solo nel prefisso saltato, quindi quella ricerca restituisce `-1`. `Slice(separator + 1)` seleziona `ada` per `Console.Out.Write`.

Lezioni correlate

  • C# · Lezione 9 · Avanzato · Versione: 3

Fonti