CKTIS / C#
System.Index y System.Range: posiciones y segmentos
Calcula posiciones desde ambos extremos, valida los límites de un segmento y distingue entre una copia y una vista de los mismos datos.
Versión: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxis
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];En C# 12 y .NET 8, System.Index y System.Range son tipos de valor inmutables del espacio de nombres System. Describen posiciones sin almacenar datos ni referencias a una secuencia. Index i = 1 usa una conversión implícita desde int y cuenta desde cero al principio. Index i = ^1 equivale a new Index(1, fromEnd: true) y señala el último elemento de una secuencia no vacía. El prefijo ^n no es a ^ b, que calcula el XOR bit a bit para enteros y el XOR lógico para bool.
i.GetOffset(length) devuelve i.Value o, si i.IsFromEnd es verdadero, length - i.Value. No comprueba si hay un elemento en esa posición. ^0 es la posición justo después del último elemento: un límite de rango válido, pero leer array[^0] produce IndexOutOfRangeException.
Range guarda dos valores Index: el inicio incluido Start y el final excluido End. start..end equivale a new Range(start, end). Si se omiten los límites, se usan 0 y ^0, respectivamente, por lo que .. describe toda la secuencia. Para una longitud dada, GetOffsetAndLength(length) devuelve (Offset, Length). Dos posiciones iguales dan un segmento vacío; los límites invertidos o las posiciones fuera de [0, length] producen ArgumentOutOfRangeException.
La compatibilidad con sequence[i] y sequence[range] depende del tipo de destino. C# admite matrices unidimensionales y string. Otro tipo puede ofrecer un indexador adecuado o seguir el patrón del compilador: una propiedad accesible int Length o int Count más un indexador int para Index o Slice(int, int) para Range. En el ejemplo, el segmento de la matriz copia los elementos y el de Span<T> es una vista sobre la misma memoria. En C# 12 no se pueden usar variables Span<T> en métodos async: es una restricción de ref struct, no de Range.
Ejemplos
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]}"));Resultado
last=50 offset=1, length=3 copy=20, source=99, view=99
`^1` señala `50`, pero `1..^1` lo excluye e incluye `20`, `30` y `40`. Escribir `99` a través de la vista cambia la matriz original, pero no la copia.
Lecciones relacionadas
- C# · Lección 51 · Avanzado · Versión: 3