Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori