CKTIS / C#
System.Index e System.Range — indici e intervalli
System.Index descrive una posizione contata dall’inizio o dalla fine di una sequenza, mentre System.Range descrive un intervallo con inizio incluso e fine esclusa. Gli operatori ^ e .. semplificano l’accesso agli elementi e la selezione di intervalli; costo e condivisione dei dati dipendono dal tipo di sequenza.
Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintassi
Index last = ^1; Range middle = 1..^1; var item = sequence[last]; var slice = sequence[middle];System.Index e System.Range sono tipi valore immutabili che supportano l’indicizzazione e la selezione di intervalli da C# 8. Sono disponibili in .NET 10; per questa funzionalità non è necessaria l’impostazione del repository LangVersion=preview. Memorizzano descrizioni di posizioni o intervalli, non la sequenza stessa né i suoi elementi.
Index memorizza Value e IsFromEnd. Un normale int non negativo viene convertito implicitamente in un indice contato dall’inizio. ^n significa la posizione Length - n: ^1 identifica l’ultimo elemento di una sequenza non vuota, mentre ^0 è il limite subito dopo la fine. Di conseguenza, values[^0] genera un’eccezione. Un valore negativo passato al costruttore Index o convertito da int causa ArgumentOutOfRangeException. GetOffset(length) calcola un offset, ma non controlla se questo identifica un elemento esistente.
Range contiene gli indici Start e End. L’espressione a..b include l’inizio ma esclude la fine; 1..^1 omette il primo e l’ultimo elemento. I limiti omessi hanno come valori predefiniti 0 e ^0: ..b, a.. e ... GetOffsetAndLength(length) restituisce un offset e il numero di elementi. Genera ArgumentOutOfRangeException se i limiti sono fuori da 0..length o se l’inizio è dopo la fine. Limiti uguali descrivono un intervallo vuoto, non un intervallo invertito.
Gli array monodimensionali, string, Span<T> e ReadOnlySpan<T> supportano questa sintassi. La sola implementazione di IEnumerable<T> non basta: servono indicizzatori adeguati o un modello riconosciuto dal compilatore. Un intervallo di un array crea una copia superficiale degli elementi; gli oggetti a cui fanno riferimento gli elementi di tipo riferimento possono comunque essere condivisi. Un intervallo di Span<T> o ReadOnlySpan<T> è una vista sulla stessa memoria, senza copiare gli elementi.
Esempi
using System;
internal static class Program
{
private static void Main()
{
int[] values = { 10, 20, 30, 40, 50 };
Index last = ^1;
Range middle = 1..^1;
int[] copy = values[middle];
copy[0] = 99;
Console.WriteLine(values[last]);
Console.WriteLine(string.Join(",", copy));
Console.WriteLine(values[1]);
var (offset, length) = middle.GetOffsetAndLength(values.Length);
Console.WriteLine($"{offset}:{length}");
}
}Risultato
50 99,30,40 20 1:3
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.