Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes