CKTIS / C#
System.Index a System.Range — indexy a rozsahy
System.Index opisuje pozíciu počítanú od začiatku alebo konca sekvencie, zatiaľ čo System.Range opisuje interval so zahrnutým začiatkom a nezahrnutým koncom. Operátory ^ a .. uľahčujú prístup k prvkom a výber rozsahov; náklady a zdieľanie údajov závisia od typu sekvencie.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
Index last = ^1; Range middle = 1..^1; var item = sequence[last]; var slice = sequence[middle];System.Index a System.Range sú nemenné hodnotové typy, ktoré od C# 8 podporujú indexovanie a výber rozsahov. Sú dostupné v .NET 10; nastavenie repozitára LangVersion=preview pre túto funkciu nie je potrebné. Ukladajú opisy pozícií alebo intervalov, nie samotnú sekvenciu ani jej prvky.
Index ukladá Value a IsFromEnd. Bežný nezáporný int sa implicitne prevedie na index počítaný od začiatku. ^n znamená pozíciu Length - n: ^1 označuje posledný prvok neprázdnej sekvencie, zatiaľ čo ^0 je hranica bezprostredne za koncom. Preto values[^0] vyvolá výnimku. Záporná hodnota odovzdaná konštruktoru Index alebo prevedená z int spôsobí ArgumentOutOfRangeException. GetOffset(length) vypočíta posun, ale nekontroluje, či označuje existujúci prvok.
Range obsahuje indexy Start a End. Výraz a..b zahŕňa začiatok, ale nezahŕňa koniec; 1..^1 vynechá prvý a posledný prvok. Vynechané hranice majú predvolené hodnoty 0 a ^0: ..b, a.. a ... GetOffsetAndLength(length) vracia posun a počet prvkov. Vyvolá ArgumentOutOfRangeException, ak hranice ležia mimo 0..length alebo začiatok leží za koncom. Rovnaké hranice označujú prázdny výrez, nie obrátený interval.
Jednorozmerné polia, string, Span<T> a ReadOnlySpan<T> túto syntax podporujú. Samotná implementácia IEnumerable<T> nestačí: potrebné sú vhodné indexery alebo vzor rozpoznávaný kompilátorom. Výrez poľa vytvára plytkú kópiu prvkov; objekty, na ktoré odkazujú prvky referenčného typu, môžu zostať zdieľané. Výrez Span<T> alebo ReadOnlySpan<T> je pohľad na tú istú pamäť, bez kopírovania prvkov.
Prí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ýsledok
50 99,30,40 20 1:3
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.