CKTIS / C#
System.Index i System.Range — indeksi i rasponi
System.Index opisuje položaj koji se broji od početka ili kraja niza, a System.Range opisuje interval kojem je početak uključen, a kraj isključen. Operatorima ^ i .. lakše je pristupiti elementima i odabrati raspone; trošak i dijeljenje podataka ovise o vrsti niza.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
Index last = ^1; Range middle = 1..^1; var item = sequence[last]; var slice = sequence[middle];System.Index i System.Range nepromjenjivi su vrijednosni tipovi koji od C# 8 podržavaju indeksiranje i odabir raspona. Dostupni su u .NET 10; postavka repozitorija LangVersion=preview nije potrebna za ovu značajku. Pohranjuju opise položaja ili intervala, a ne sam niz ili njegove elemente.
Index pohranjuje Value i IsFromEnd. Običan nenegativni int implicitno se pretvara u indeks koji se broji od početka. ^n znači položaj Length - n: ^1 označava posljednji element nepraznog niza, dok je ^0 granica odmah nakon kraja. Zato values[^0] izaziva iznimku. Negativna vrijednost predana konstruktoru Index ili pretvorena iz int uzrokuje ArgumentOutOfRangeException. GetOffset(length) računa pomak, ali ne provjerava označava li postojeći element.
Range sadrži indekse Start i End. Izraz a..b uključuje početak, ali isključuje kraj; 1..^1 izostavlja prvi i posljednji element. Izostavljene granice prema zadanim postavkama imaju vrijednosti 0 i ^0: ..b, a.. i ... GetOffsetAndLength(length) vraća pomak i broj elemenata. Izaziva ArgumentOutOfRangeException ako su granice izvan 0..length ili je početak nakon kraja. Jednake granice opisuju prazan izrez, a ne obrnuti interval.
Jednodimenzionalni nizovi, string, Span<T> i ReadOnlySpan<T> podržavaju ovu sintaksu. Sama implementacija IEnumerable<T> nije dovoljna: potrebni su odgovarajući indekseri ili obrazac koji prepoznaje prevoditelj. Izrez niza stvara plitku kopiju elemenata; objekti na koje upućuju elementi referentnog tipa i dalje se mogu dijeliti. Izrez Span<T> ili ReadOnlySpan<T> prikaz je istog memorijskog prostora, bez kopiranja elemenata.
Primjeri
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}");
}
}Rezultat
50 99,30,40 20 1:3
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.