CKTIS / C#
System.Index e System.Range — índices e intervalos
System.Index descreve uma posição contada a partir do início ou do fim de uma sequência, enquanto System.Range descreve um intervalo com início incluído e fim excluído. Os operadores ^ e .. simplificam o acesso a elementos e a seleção de intervalos; o custo e a partilha de dados dependem do tipo de sequência.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
Index last = ^1; Range middle = 1..^1; var item = sequence[last]; var slice = sequence[middle];System.Index e System.Range são tipos de valor imutáveis que suportam indexação e seleção de intervalos desde C# 8. Estão disponíveis no .NET 10; a definição do repositório LangVersion=preview não é necessária para esta funcionalidade. Armazenam descrições de posições ou intervalos, não a sequência em si nem os seus elementos.
Index armazena Value e IsFromEnd. Um int normal não negativo é convertido implicitamente num índice contado a partir do início. ^n significa a posição Length - n: ^1 identifica o último elemento de uma sequência não vazia, enquanto ^0 é o limite imediatamente após o fim. Por isso, values[^0] gera uma exceção. Um valor negativo passado ao construtor Index ou convertido de int provoca ArgumentOutOfRangeException. GetOffset(length) calcula um deslocamento, mas não verifica se este identifica um elemento existente.
Range contém os índices Start e End. A expressão a..b inclui o início, mas exclui o fim; 1..^1 omite o primeiro e o último elemento. Os limites omitidos têm como valores predefinidos 0 e ^0: ..b, a.. e ... GetOffsetAndLength(length) devolve um deslocamento e o número de elementos. Gera ArgumentOutOfRangeException se os limites estiverem fora de 0..length ou se o início ficar depois do fim. Limites iguais descrevem um intervalo vazio, não um intervalo invertido.
Arrays unidimensionais, string, Span<T> e ReadOnlySpan<T> suportam esta sintaxe. Implementar apenas IEnumerable<T> não é suficiente: são necessários indexadores adequados ou um padrão reconhecido pelo compilador. Um intervalo de um array cria uma cópia superficial dos elementos; os objetos referenciados pelos elementos de tipo referência podem continuar a ser partilhados. Um intervalo de Span<T> ou ReadOnlySpan<T> é uma vista da mesma memória, sem copiar os elementos.
Exemplos
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}");
}
}Resultado
50 99,30,40 20 1:3
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.