Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

System.Index a System.Range — indexy a rozsahy

System.Index popisuje pozici počítanou od začátku nebo konce sekvence, zatímco System.Range popisuje interval se zahrnutým začátkem a nezahrnutým koncem. Operátory ^ a .. usnadňují přístup k prvkům a výběr rozsahů; náklady a sdílení dat závisí na typu sekvence.

Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

Index last = ^1; Range middle = 1..^1; var item = sequence[last]; var slice = sequence[middle];

System.Index a System.Range jsou neměnné hodnotové typy, které od C# 8 podporují indexování a výběr rozsahů. Jsou dostupné v .NET 10; nastavení repozitáře LangVersion=preview pro tuto funkci není nutné. Ukládají popisy pozic nebo intervalů, nikoli samotnou sekvenci ani její prvky.

Index ukládá Value a IsFromEnd. Běžný nezáporný int se implicitně převede na index počítaný od začátku. ^n znamená pozici Length - n: ^1 označuje poslední prvek neprázdné sekvence, zatímco ^0 je hranice bezprostředně za koncem. Proto values[^0] vyvolá výjimku. Záporná hodnota předaná konstruktoru Index nebo převedená z int způsobí ArgumentOutOfRangeException. GetOffset(length) vypočítá posun, ale nekontroluje, zda označuje existující prvek.

Range obsahuje indexy Start a End. Výraz a..b zahrnuje začátek, ale nezahrnuje konec; 1..^1 vynechá první a poslední prvek. Vynechané hranice mají výchozí hodnoty 0 a ^0: ..b, a.. a ... GetOffsetAndLength(length) vrací posun a počet prvků. Vyvolá ArgumentOutOfRangeException, pokud hranice leží mimo 0..length nebo začátek leží za koncem. Shodné hranice označují prázdný výřez, nikoli obrácený interval.

Jednorozměrná pole, string, Span<T> a ReadOnlySpan<T> tuto syntaxi podporují. Samotná implementace IEnumerable<T> nestačí: jsou potřeba vhodné indexery nebo vzor rozpoznávaný kompilátorem. Výřez pole vytváří mělkou kopii prvků; objekty, na které odkazují prvky referenčního typu, mohou zůstat sdílené. Výřez Span<T> nebo ReadOnlySpan<T> je pohled na stejnou paměť, bez kopírování prvků.

Pří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ýsledek

50
99,30,40
20
1:3

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje