Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

System.Index i System.Range: pozycje i wycinki

Dowiedz się, jak obliczać pozycje od początku i od końca, sprawdzać granice zakresu oraz odróżniać kopię od widoku na te same dane.

Wersja: C# 12 and .NET 8; later runtimes may add compatible features

Składnia

System.Index fromStart = 1;
System.Index fromEnd = ^1;
System.Index explicitIndex = new System.Index(1, fromEnd: true);
System.Range range = fromStart..fromEnd;
System.Range explicitRange = new System.Range(fromStart, fromEnd);
System.Range all = ..;
int offset = fromEnd.GetOffset(length);
(int start, int count) = range.GetOffsetAndLength(length);
var item = sequence[fromEnd];
var slice = sequence[range];

W C# 12 i .NET 8 System.Index oraz System.Range to niemodyfikowalne typy wartościowe z przestrzeni nazw System. Opisują pozycje bez przechowywania danych ani odwołania do sekwencji. Index i = 1 używa konwersji niejawnej z int i liczy od zera od początku. Index i = ^1 jest równoważne new Index(1, fromEnd: true) i wskazuje ostatni element niepustej sekwencji. Prefiks ^n nie jest operatorem a ^ b, który oblicza bitowy XOR dla liczb całkowitych, a logiczny XOR dla bool.

i.GetOffset(length) zwraca i.Value lub, gdy i.IsFromEnd jest prawdą, length - i.Value. Nie sprawdza, czy pod tą pozycją istnieje element. ^0 oznacza pozycję tuż za ostatnim elementem: to poprawna granica zakresu, ale odczyt array[^0] zgłasza IndexOutOfRangeException.

Range przechowuje dwie wartości Index: włączony początek Start i wyłączony koniec End. start..end odpowiada new Range(start, end). Pominięte granice to odpowiednio 0 i ^0, więc .. opisuje całą sekwencję. Dla podanej długości GetOffsetAndLength(length) zwraca (Offset, Length). Równe pozycje dają pusty wycinek; odwrócone granice lub granice spoza przedziału [0, length] powodują ArgumentOutOfRangeException.

Obsługa sequence[i] i sequence[range] zależy od typu. C# obsługuje tablice jednowymiarowe i string; inny typ może udostępnić odpowiedni indekser lub spełnić wzorzec kompilatora: dostępne int Length albo int Count oraz indekser z int dla Index lub Slice(int, int) dla Range. W przykładzie wycinek tablicy kopiuje elementy, a wycinek Span<T> jest widokiem na te same dane. W C# 12 zmiennych Span<T> nie można używać w metodach async; to ograniczenie ref struct, a nie Range.

Przykłady

using System;

int[] data = { 10, 20, 30, 40, 50 };
Index last = ^1;
Range window = 1..last;
(int offset, int length) = window.GetOffsetAndLength(data.Length);

int[] copy = data[window];
Span<int> span = data.AsSpan();
Span<int> view = span[window];
view[0] = 99;

Console.WriteLine(FormattableString.Invariant($"last={data[last]}"));
Console.WriteLine(FormattableString.Invariant($"offset={offset}, length={length}"));
Console.WriteLine(FormattableString.Invariant($"copy={copy[0]}, source={data[offset]}, view={view[0]}"));

Wynik

last=50
offset=1, length=3
copy=20, source=99, view=99

`^1` wskazuje `50`, ale zakres `1..^1` wyklucza ten element i obejmuje `20`, `30`, `40`. Zapis `99` przez widok zmienia tablicę źródłową, ale nie kopię.

Powiązane lekcje

  • C# · Lekcja 51 · Zaawansowany · Wersja: 3

Źródła