Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti