Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

System.Index e System.Range: posizioni e porzioni

Calcola posizioni dall’inizio o dalla fine, verifica i limiti di una porzione e distingui una copia da una vista sugli stessi dati.

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

Sintassi

System.Index fromStart = 1;
System.Index fromEnd = ^1;
System.Index explicitIndex = new System.Index(1, fromEnd: true);
System.Range range = fromStart..fromEnd;
System.Range explicitRange = new System.Range(fromStart, fromEnd);
System.Range all = ..;
int offset = fromEnd.GetOffset(length);
(int start, int count) = range.GetOffsetAndLength(length);
var item = sequence[fromEnd];
var slice = sequence[range];

In C# 12 e .NET 8, System.Index e System.Range sono tipi valore immutabili nello spazio dei nomi System. Descrivono posizioni senza conservare dati né riferimenti a una sequenza. Index i = 1 usa una conversione implicita da int e conta da zero a partire dall’inizio. Index i = ^1 equivale a new Index(1, fromEnd: true) e indica l’ultimo elemento di una sequenza non vuota. Il prefisso ^n è diverso da a ^ b, che calcola lo XOR bit a bit per gli interi e lo XOR logico per bool.

i.GetOffset(length) restituisce i.Value oppure, se i.IsFromEnd è vero, length - i.Value. Non verifica che in quella posizione ci sia un elemento. ^0 è la posizione subito dopo l’ultimo elemento: un limite valido per un intervallo, ma leggere array[^0] genera IndexOutOfRangeException.

Range contiene due valori Index: l’inizio incluso Start e la fine esclusa End. start..end equivale a new Range(start, end). Se omessi, i limiti valgono rispettivamente 0 e ^0, quindi .. descrive l’intera sequenza. Data la lunghezza, GetOffsetAndLength(length) restituisce (Offset, Length). Posizioni uguali producono una porzione vuota; limiti invertiti o posizioni esterne a [0, length] causano ArgumentOutOfRangeException.

Il supporto per sequence[i] e sequence[range] dipende dal tipo di destinazione. C# supporta gli array unidimensionali e string. Un altro tipo può esporre un indicizzatore adatto o rispettare lo schema del compilatore: una proprietà accessibile int Length o int Count e un indicizzatore int per Index o Slice(int, int) per Range. Nell’esempio, la porzione dell’array copia gli elementi, mentre quella di Span<T> è una vista sulla stessa memoria. In C# 12 non si possono usare variabili Span<T> nei metodi async: è un vincolo di ref struct, non di Range.

Esempi

using System;

int[] data = { 10, 20, 30, 40, 50 };
Index last = ^1;
Range window = 1..last;
(int offset, int length) = window.GetOffsetAndLength(data.Length);

int[] copy = data[window];
Span<int> span = data.AsSpan();
Span<int> view = span[window];
view[0] = 99;

Console.WriteLine(FormattableString.Invariant($"last={data[last]}"));
Console.WriteLine(FormattableString.Invariant($"offset={offset}, length={length}"));
Console.WriteLine(FormattableString.Invariant($"copy={copy[0]}, source={data[offset]}, view={view[0]}"));

Risultato

last=50
offset=1, length=3
copy=20, source=99, view=99

`^1` indica `50`, ma `1..^1` lo esclude e include `20`, `30` e `40`. Scrivere `99` tramite la vista modifica l’array originale, ma non la copia.

Lezioni correlate

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

Fonti