CKTIS / C#
System.Index y System.Range — índices y rangos
System.Index describe una posición contada desde el principio o el final de una secuencia, mientras que System.Range describe un intervalo que incluye el inicio y excluye el final. Los operadores ^ y .. simplifican el acceso a elementos y la selección de rangos; el coste y el uso compartido de datos dependen del tipo de secuencia.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
Index last = ^1; Range middle = 1..^1; var item = sequence[last]; var slice = sequence[middle];System.Index y System.Range son tipos de valor inmutables que admiten la indexación y la selección de rangos desde C# 8. Están disponibles en .NET 10; no se necesita la configuración del repositorio LangVersion=preview para esta característica. Almacenan descripciones de posiciones o intervalos, no la secuencia en sí ni sus elementos.
Index almacena Value y IsFromEnd. Un int normal no negativo se convierte implícitamente en un índice contado desde el principio. ^n significa la posición Length - n: ^1 identifica el último elemento de una secuencia no vacía, mientras que ^0 es el límite situado justo después del final. Por tanto, values[^0] produce una excepción. Un valor negativo pasado al constructor Index o convertido desde int provoca ArgumentOutOfRangeException. GetOffset(length) calcula un desplazamiento, pero no comprueba si identifica un elemento existente.
Range contiene los índices Start y End. La expresión a..b incluye el inicio, pero excluye el final; 1..^1 omite el primer y el último elemento. Los límites omitidos tienen por defecto los valores 0 y ^0: ..b, a.. y ... GetOffsetAndLength(length) devuelve un desplazamiento y el número de elementos. Produce ArgumentOutOfRangeException si los límites quedan fuera de 0..length o si el inicio queda después del final. Los límites iguales describen un rango vacío, no un intervalo invertido.
Los arrays unidimensionales, string, Span<T> y ReadOnlySpan<T> admiten esta sintaxis. Implementar únicamente IEnumerable<T> no basta: se necesitan indexadores adecuados o un patrón reconocido por el compilador. Un rango de un array crea una copia superficial de los elementos; los objetos a los que apuntan los elementos de tipo referencia pueden seguir compartiéndose. Un rango de Span<T> o ReadOnlySpan<T> es una vista de la misma memoria, sin copiar los elementos.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.