Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

Cercare, confrontare e convertire dati nelle viste span

Cerca e confronta viste di testo senza copiarlo, poi converti i campi in `int` o `decimal` con regole di formato esplicite.

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

Sintassi

using System;
using System.Globalization;

// Selected call forms for C# 12 / .NET 8:
ReadOnlySpan<char> text = sourceString.AsSpan();
ReadOnlySpan<char> part = sourceString.AsSpan(start, length);
Span<int> elements = sourceArray.AsSpan(); // sourceArray is int[]
int elementIndex = text.IndexOf(':');
int sequenceIndex = text.IndexOf(needle); // needle is ReadOnlySpan<char>
int textIndex = text.IndexOf(needle, StringComparison.OrdinalIgnoreCase);
bool same = text.SequenceEqual(needle);
bool sameIgnoringCase = MemoryExtensions.Equals(text, needle, StringComparison.OrdinalIgnoreCase);
bool intOk = int.TryParse(part, NumberStyles.None, CultureInfo.InvariantCulture, out int count);
bool decimalOk = decimal.TryParse(part, NumberStyles.AllowDecimalPoint, CultureInfo.InvariantCulture, out decimal price);

In C# 12 e .NET 8, using System; rende disponibili i metodi di estensione di System.MemoryExtensions. AsSpan() crea una vista senza copiare i dati: da una string ottieni un ReadOnlySpan<char>, da un array T[] uno Span<T> scrivibile. L’overload AsSpan<T> per gli array genera un’eccezione ArrayTypeMismatchException se l’array viene passato per covarianza, per esempio quando uno string[] viene passato come object[]. AsSpan(start, length) seleziona una porzione; limiti non validi con un’origine diversa da null causano ArgumentOutOfRangeException. La forma senza argomenti restituisce una vista vuota per una stringa null. Entrambi i tipi span sono ref struct: la vista non deve sopravvivere alla memoria sottostante e in C# 12 non puoi dichiarare variabili span locali in metodi asincroni o iteratori.

IndexOf cerca un singolo elemento o una sequenza contigua. Restituisce l’indice della prima corrispondenza a partire da zero nella vista esaminata, oppure -1 se non la trova; una sequenza vuota dà 0. Controlla l’indice prima di ricavare una porzione. Gli overload generici mostrati usano IEquatable<T>; per char confrontano unità di codice UTF-16. Non è String.IndexOf: l’overload con string usa per impostazione predefinita le impostazioni cultura correnti, mentre quello con char è ordinale. Per cercare nel testo senza distinguere maiuscole e minuscole, usa l’overload con StringComparison.OrdinalIgnoreCase.

SequenceEqual richiede la stessa lunghezza ed elementi uguali nelle posizioni corrispondenti. Negli span di char, la chiamata mostrata distingue maiuscole e minuscole e non normalizza Unicode; per ignorare la distinzione usa MemoryExtensions.Equals con StringComparison.OrdinalIgnoreCase. Per gli span, == verifica la posizione iniziale in memoria e la lunghezza, non il contenuto. Il metodo LINQ System.Linq.Enumerable.SequenceEqual opera su IEnumerable<T>, non sugli span. Non dare per scontato che SequenceEqual impieghi un tempo costante: per confrontare sequenze segrete di byte di uguale lunghezza usa CryptographicOperations.FixedTimeEquals.

int.TryParse e decimal.TryParse accettano ReadOnlySpan<char> senza creare una sottostringa. Scegli NumberStyles e le impostazioni cultura in base al formato: qui NumberStyles.None non abilita elementi di formato facoltativi, mentre NumberStyles.AllowDecimalPoint ammette il separatore decimale, che è . con CultureInfo.InvariantCulture. In .NET 8 entrambi i metodi ignorano i caratteri U+0000 in coda al campo, anche con queste impostazioni. Se il formato li vieta, rifiutali esplicitamente prima della conversione. Usa il valore out solo dopo true. Un campo vuoto o un overflow di un intero restituisce false, ma un valore non valido di NumberStyles può generare un’eccezione.

Esempi

using System;
using System.Globalization;

ReadOnlySpan<char> record = "item:42;19.95".AsSpan();
int colon = record.IndexOf(":".AsSpan());
if (colon < 0 || !record[..colon].SequenceEqual("item".AsSpan()))
{
    Console.WriteLine("Invalid record.");
    return;
}

ReadOnlySpan<char> fields = record[(colon + 1)..];
int separator = fields.IndexOf(';');
var culture = CultureInfo.InvariantCulture;
if (separator < 0 ||
    !int.TryParse(fields[..separator], NumberStyles.None, culture, out int count) ||
    !decimal.TryParse(fields[(separator + 1)..], NumberStyles.AllowDecimalPoint, culture, out decimal price))
{
    Console.WriteLine("Invalid record.");
    return;
}

Console.WriteLine(FormattableString.Invariant($"count={count}; price={price:0.00}"));

Risultato

count=42; price=19.95

Il programma controlla l’etichetta `item`, trova entrambi i separatori e converte due campi senza creare sottostringhe. L’indice del punto e virgola è relativo a `fields`, non a `record`.

Lezioni correlate

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

Fonti