CKTIS / C#
System.Index e System.Range: posições e segmentos
Calcula posições a partir do início ou do fim, valida os limites de um segmento e distingue uma cópia de uma vista sobre os mesmos dados.
Versão: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxe
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];Em C# 12 e .NET 8, System.Index e System.Range são tipos de valor imutáveis no espaço de nomes System. Descrevem posições sem guardar dados nem referências a uma sequência. Index i = 1 usa uma conversão implícita de int e conta a partir de zero no início. Index i = ^1 equivale a new Index(1, fromEnd: true) e indica o último elemento de uma sequência não vazia. O prefixo ^n é diferente de a ^ b, que calcula o XOR bit a bit para inteiros e o XOR lógico para bool.
i.GetOffset(length) devolve i.Value ou, se i.IsFromEnd for verdadeiro, length - i.Value. Não verifica se existe um elemento nessa posição. ^0 é a posição imediatamente a seguir ao último elemento: é um limite válido de um intervalo, mas ler array[^0] lança IndexOutOfRangeException.
Range guarda dois valores Index: o início incluído Start e o fim excluído End. start..end equivale a new Range(start, end). Se forem omitidos, os limites são 0 e ^0, respetivamente, pelo que .. descreve toda a sequência. Para um dado comprimento, GetOffsetAndLength(length) devolve (Offset, Length). Posições iguais dão um segmento vazio; limites invertidos ou posições fora de [0, length] provocam ArgumentOutOfRangeException.
O suporte de sequence[i] e sequence[range] depende do tipo de destino. C# suporta matrizes unidimensionais e string. Outro tipo pode disponibilizar um indexador adequado ou seguir o padrão do compilador: uma propriedade acessível int Length ou int Count e um indexador int para Index ou Slice(int, int) para Range. No exemplo, o segmento da matriz copia os elementos, enquanto o de Span<T> é uma vista sobre a mesma memória. Em C# 12 não se podem usar variáveis Span<T> em métodos async: trata-se de uma restrição de ref struct, não de Range.
Exemplos
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` indica `50`, mas `1..^1` exclui esse valor e inclui `20`, `30` e `40`. Escrever `99` através da vista altera a matriz original, mas não a cópia.
Lições relacionadas
- C# · Lição 51 · Avançado · Versão: 3