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

CKTIS / C#

System.Index a System.Range: pozície a výrezy

Zistite, ako určiť pozíciu od začiatku či konca, overiť hranice výrezu a rozlíšiť kópiu od pohľadu na tie isté údaje.

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

Syntax

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 sú System.Index a System.Range nemenné hodnotové typy v priestore názvov System. Opisujú pozície bez uchovávania údajov alebo odkazu na postupnosť. Index i = 1 využíva implicitnú konverziu z int a počíta od začiatku od nuly. Index i = ^1 zodpovedá new Index(1, fromEnd: true) a označuje posledný prvok neprázdnej postupnosti. Prefix ^n nie je to isté ako a ^ b, čo je bitový XOR pre celé čísla a logický XOR pre bool.

i.GetOffset(length) vráti i.Value alebo, ak je i.IsFromEnd pravda, length - i.Value. Nekontroluje, či na tejto pozícii existuje prvok. ^0 označuje pozíciu hneď za posledným prvkom: je to platná hranica rozsahu, ale čítanie array[^0] vyvolá IndexOutOfRangeException.

Range uchováva dve hodnoty Index: zahrnutý začiatok Start a nezahrnutý koniec End. start..end zodpovedá new Range(start, end). Vynechané hranice majú hodnoty 0 a ^0, takže .. opisuje celú postupnosť. Pre danú dĺžku vráti GetOffsetAndLength(length) dvojicu (Offset, Length). Rovnaké pozície dajú prázdny výrez; obrátené hranice alebo pozície mimo [0, length] vyvolajú ArgumentOutOfRangeException.

Podpora sequence[i] a sequence[range] závisí od cieľového typu. C# podporuje jednorozmerné polia a string. Iný typ môže poskytnúť vhodný indexer alebo splniť vzor kompilátora: prístupnú vlastnosť int Length alebo int Count a indexer s int pre Index alebo metódu Slice(int, int) pre Range. V príklade výrez poľa kopíruje prvky, zatiaľ čo výrez Span<T> je pohľad do tej istej pamäte. V C# 12 nemožno používať premenné Span<T> v metódach async; ide o obmedzenie ref struct, nie Range.

Prí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ýsledok

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

`^1` označuje `50`, ale `1..^1` ho vynechá a zahrnie `20`, `30` a `40`. Zápis `99` prostredníctvom pohľadu zmení pôvodné pole, nie kópiu.

Súvisiace lekcie

  • C# · Lekcia 51 · Pokročilá · Verzia: 3

Zdroje