Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

System.Index i System.Range: položaji i isječci

Izračunajte položaje od početka ili kraja, provjerite granice isječka i razlikujte kopiju od pogleda na iste podatke.

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

Sintaksa

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

U C# 12 i .NET 8 System.Index i System.Range nepromjenjivi su vrijednosni tipovi u imenskom prostoru System. Opisuju položaje bez pohrane podataka ili reference na slijed. Index i = 1 koristi implicitnu pretvorbu iz int i broji od nule na početku. Index i = ^1 ekvivalentno je izrazu new Index(1, fromEnd: true) i označava posljednji element nepraznog slijeda. Prefiks ^n nije isto što i a ^ b, koji računa bitovni XOR za cijele brojeve i logički XOR za bool.

i.GetOffset(length) vraća i.Value ili, ako je i.IsFromEnd istinit, length - i.Value. Ne provjerava postoji li element na tom položaju. ^0 je položaj neposredno iza posljednjeg elementa: valjana granica raspona, ali čitanje array[^0] izaziva IndexOutOfRangeException.

Range pohranjuje dvije vrijednosti Index: uključeni početak Start i isključeni kraj End. start..end odgovara izrazu new Range(start, end). Izostavljene granice zamjenjuju se redom vrijednostima 0 i ^0, pa .. opisuje cijeli slijed. Za zadanu duljinu GetOffsetAndLength(length) vraća (Offset, Length). Jednaki položaji daju prazan isječak; obrnute granice ili položaji izvan [0, length] izazivaju ArgumentOutOfRangeException.

Podrška za sequence[i] i sequence[range] ovisi o ciljnom tipu. C# podržava jednodimenzionalna polja i string. Drugi tip može ponuditi odgovarajući indekser ili slijediti obrazac koji prepoznaje prevoditelj: dostupno svojstvo int Length ili int Count i indekser s parametrom int za Index ili metodu Slice(int, int) za Range. U primjeru isječak polja kopira elemente, a isječak Span<T> pruža pogled na istu memoriju. U C# 12 nije moguće koristiti varijable Span<T> u metodama async; to je ograničenje tipa ref struct, a ne tipa Range.

Primjeri

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

Rezultat

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

`^1` označava `50`, ali `1..^1` isključuje tu vrijednost i obuhvaća `20`, `30` i `40`. Upis vrijednosti `99` kroz pogled mijenja izvorno polje, ali ne i kopiju.

Povezane lekcije

  • C# · Lekcija 51 · Napredno · Verzija: 3

Izvori