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

CKTIS / C#

System.Index a System.Range: pozice a výřezy

Zjistěte, jak určit pozici od začátku či konce, ověřit hranice výřezu a rozlišit kopii od pohledu na stejná data.

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

Syntaxe

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];

V C# 12 a .NET 8 jsou System.Index a System.Range neměnné hodnotové typy v oboru názvů System. Popisují pozice, aniž by uchovávaly data nebo odkaz na posloupnost. Index i = 1 využívá implicitní převod z int a počítá od začátku od nuly. Index i = ^1 odpovídá new Index(1, fromEnd: true) a označuje poslední prvek neprázdné posloupnosti. Prefix ^n není totéž co a ^ b, které provádí bitový XOR pro celá čísla a logický XOR pro bool.

i.GetOffset(length) vrací i.Value, nebo pokud je i.IsFromEnd pravda, length - i.Value. Nekontroluje, zda na této pozici existuje prvek. ^0 označuje pozici hned za posledním prvkem: jako hranice rozsahu je platná, ale čtení array[^0] vyvolá IndexOutOfRangeException.

Range obsahuje dvě hodnoty Index: zahrnutý začátek Start a nezahrnutý konec End. start..end odpovídá new Range(start, end). Vynechané hranice mají hodnoty 0 a ^0, takže .. popisuje celou posloupnost. Pro danou délku vrací GetOffsetAndLength(length) dvojici (Offset, Length). Stejné pozice dávají prázdný výřez; obrácené hranice nebo pozice mimo [0, length] vyvolají ArgumentOutOfRangeException.

Podpora sequence[i] a sequence[range] závisí na cílovém typu. C# podporuje jednorozměrná pole a string. Jiný typ může nabídnout odpovídající indexer nebo splnit vzor překladače: přístupnou vlastnost int Length nebo int Count a indexer s int pro Index nebo metodu Slice(int, int) pro Range. V příkladu výřez pole kopíruje prvky, zatímco výřez Span<T> je pohled do téže paměti. V C# 12 nelze používat proměnné Span<T> v metodách async; jde o omezení ref struct, nikoli Range.

Příklady

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

Výsledek

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

`^1` označuje `50`, ale `1..^1` jej vynechá a zahrne `20`, `30` a `40`. Zápis `99` prostřednictvím pohledu změní původní pole, nikoli kopii.

Související lekce

  • C# · Lekce 51 · Pokročilá · Verze: 3

Zdroje