Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje