Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

System.Index in System.Range — indeksi in obsegi

System.Index opisuje položaj, štet od začetka ali konca zaporedja, System.Range pa interval, ki vključuje začetek in izključuje konec. Operatorja ^ in .. olajšata dostop do elementov in izbiro obsegov; stroški in souporaba podatkov so odvisni od vrste zaporedja.

Različica: .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 in System.Range sta nespremenljiva vrednostna tipa, ki od C# 8 podpirata indeksiranje in izbiro obsegov. Na voljo sta v .NET 10; nastavitev repozitorija LangVersion=preview za to funkcijo ni potrebna. Shranjujeta opise položajev ali intervalov, ne pa zaporedja samega ali njegovih elementov.

Index shranjuje Value in IsFromEnd. Navaden nenegativen int se implicitno pretvori v indeks, štet od začetka. ^n pomeni položaj Length - n: ^1 označuje zadnji element nepraznega zaporedja, ^0 pa mejo tik za koncem. Zato values[^0] sproži izjemo. Negativna vrednost, podana konstruktorju Index ali pretvorjena iz int, povzroči ArgumentOutOfRangeException. GetOffset(length) izračuna odmik, vendar ne preveri, ali označuje obstoječi element.

Range vsebuje indeksa Start in End. Izraz a..b vključuje začetek, konec pa izključi; 1..^1 izpusti prvi in zadnji element. Izpuščeni meji imata privzeti vrednosti 0 in ^0: ..b, a.. in ... GetOffsetAndLength(length) vrne odmik in število elementov. Sproži ArgumentOutOfRangeException, če sta meji zunaj 0..length ali je začetek za koncem. Enaki meji opisujeta prazen izsek, ne obrnjenega intervala.

Enodimenzionalna polja, string, Span<T> in ReadOnlySpan<T> podpirajo to sintakso. Zgolj implementacija IEnumerable<T> ne zadostuje: potrebni so ustrezni indeksatorji ali vzorec, ki ga prepozna prevajalnik. Izsek polja ustvari plitvo kopijo elementov; objekti, na katere kažejo elementi referenčnega tipa, so lahko še vedno v skupni rabi. Izsek Span<T> ali ReadOnlySpan<T> je pogled na isti pomnilnik, brez kopiranja elementov.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri