Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

System.Index i System.Range — indeksy i wycinki

System.Index opisuje pozycję liczoną od początku lub końca sekwencji, a System.Range — przedział z włączonym początkiem i wyłączonym końcem. Operatory ^ i .. ułatwiają dostęp do elementów i wycinków; koszt oraz współdzielenie danych zależą od typu sekwencji.

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

Składnia

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

System.Index i System.Range to niemutowalne typy wartościowe wspierające indeksowanie i wycinanie od C# 8. Są dostępne w .NET 10; ustawienie repozytorium LangVersion=preview nie jest wymagane dla tej funkcji. Przechowują opis pozycji lub przedziału, a nie samą sekwencję ani jej elementy.

Index przechowuje Value oraz IsFromEnd. Zwykły nieujemny int jest niejawnie konwertowany na indeks od początku. ^n oznacza pozycję Length - n: ^1 wskazuje ostatni element niepustej sekwencji, natomiast ^0 jest granicą za końcem. Dlatego values[^0] zgłasza wyjątek. Ujemna wartość przekazana do konstruktora Index lub konwersji z int powoduje ArgumentOutOfRangeException. GetOffset(length) oblicza przesunięcie, ale nie sprawdza, czy wskazuje ono istniejący element.

Range zawiera indeksy Start i End. Zapis a..b włącza początek, lecz wyłącza koniec; 1..^1 pomija pierwszy i ostatni element. Pominięte granice domyślnie wynoszą 0 i ^0: ..b, a.. oraz ... GetOffsetAndLength(length) zwraca przesunięcie i liczbę elementów. Zgłasza ArgumentOutOfRangeException, jeśli granice wykraczają poza 0..length lub początek wypada po końcu. Równe granice oznaczają pusty wycinek, a nie odwrócony przedział.

Jednowymiarowe tablice, string, Span<T> i ReadOnlySpan<T> obsługują tę składnię. Samo implementowanie IEnumerable<T> nie wystarcza: potrzebne jest odpowiednie wsparcie indeksatorów lub wzorca rozpoznawanego przez kompilator. Wycinek tablicy tworzy płytką kopię elementów; obiekty wskazywane przez elementy referencyjne nadal mogą być współdzielone. Wycinek Span<T> lub ReadOnlySpan<T> jest widokiem na tę samą pamięć, bez kopiowania elementów.

Przykłady

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}");
    }
}

Wynik

50
99,30,40
20
1:3

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła