CKTIS / C#
System.Index a System.Range — indexy a rozsahy
System.Index popisuje pozici počítanou od začátku nebo konce sekvence, zatímco System.Range popisuje interval se zahrnutým začátkem a nezahrnutým koncem. Operátory ^ a .. usnadňují přístup k prvkům a výběr rozsahů; náklady a sdílení dat závisí na typu sekvence.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
Index last = ^1; Range middle = 1..^1; var item = sequence[last]; var slice = sequence[middle];System.Index a System.Range jsou neměnné hodnotové typy, které od C# 8 podporují indexování a výběr rozsahů. Jsou dostupné v .NET 10; nastavení repozitáře LangVersion=preview pro tuto funkci není nutné. Ukládají popisy pozic nebo intervalů, nikoli samotnou sekvenci ani její prvky.
Index ukládá Value a IsFromEnd. Běžný nezáporný int se implicitně převede na index počítaný od začátku. ^n znamená pozici Length - n: ^1 označuje poslední prvek neprázdné sekvence, zatímco ^0 je hranice bezprostředně za koncem. Proto values[^0] vyvolá výjimku. Záporná hodnota předaná konstruktoru Index nebo převedená z int způsobí ArgumentOutOfRangeException. GetOffset(length) vypočítá posun, ale nekontroluje, zda označuje existující prvek.
Range obsahuje indexy Start a End. Výraz a..b zahrnuje začátek, ale nezahrnuje konec; 1..^1 vynechá první a poslední prvek. Vynechané hranice mají výchozí hodnoty 0 a ^0: ..b, a.. a ... GetOffsetAndLength(length) vrací posun a počet prvků. Vyvolá ArgumentOutOfRangeException, pokud hranice leží mimo 0..length nebo začátek leží za koncem. Shodné hranice označují prázdný výřez, nikoli obrácený interval.
Jednorozměrná pole, string, Span<T> a ReadOnlySpan<T> tuto syntaxi podporují. Samotná implementace IEnumerable<T> nestačí: jsou potřeba vhodné indexery nebo vzor rozpoznávaný kompilátorem. Výřez pole vytváří mělkou kopii prvků; objekty, na které odkazují prvky referenčního typu, mohou zůstat sdílené. Výřez Span<T> nebo ReadOnlySpan<T> je pohled na stejnou paměť, bez kopírování prvků.
Příklady
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}");
}
}Výsledek
50 99,30,40 20 1:3
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.