CKTIS / C#
System.Index in System.Range: položaji in izseki
Izračunajte položaje od začetka ali konca, preverite meje izseka in ločite kopijo od pogleda na iste podatke.
Različica: 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];V C# 12 in .NET 8 sta System.Index in System.Range nespremenljiva vrednostna tipa v imenskem prostoru System. Opisujeta položaje, ne da bi hranila podatke ali sklic na zaporedje. Index i = 1 uporabi implicitno pretvorbo iz int in šteje od začetka od nič. Index i = ^1 je enakovredno new Index(1, fromEnd: true) in označuje zadnji element nepraznega zaporedja. Predpona ^n ni isto kot a ^ b, ki izračuna bitni XOR za cela števila in logični XOR za bool.
i.GetOffset(length) vrne i.Value ali, če je i.IsFromEnd resničen, length - i.Value. Ne preveri, ali na tem položaju obstaja element. ^0 je položaj takoj za zadnjim elementom: veljavna meja obsega, vendar branje array[^0] sproži IndexOutOfRangeException.
Range hrani dve vrednosti Index: vključeni začetek Start in izključeni konec End. start..end je enakovredno new Range(start, end). Če mejo izpustimo, se za začetek uporabi 0, za konec pa ^0, zato .. opisuje celotno zaporedje. Za dano dolžino GetOffsetAndLength(length) vrne (Offset, Length). Enaka položaja pomenita prazen izsek; obrnjeni meji ali položaji zunaj [0, length] sprožijo ArgumentOutOfRangeException.
Podpora za sequence[i] in sequence[range] je odvisna od ciljnega tipa. C# podpira enodimenzionalne tabele in string. Drug tip lahko ponudi ustrezen indekser ali sledi vzorcu prevajalnika: dostopna lastnost int Length ali int Count ter indekser z int za Index ali metoda Slice(int, int) za Range. V primeru izsek tabele kopira elemente, izsek Span<T> pa je pogled na isti pomnilnik. V C# 12 spremenljivk Span<T> ni mogoče uporabiti v metodah async; to je omejitev ref struct, ne Range.
Primeri
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čuje `50`, vendar ga `1..^1` izključi in zajame `20`, `30` in `40`. Zapis `99` prek pogleda spremeni izvorno tabelo, ne pa kopije.
Povezane lekcije
- C# · Lekcija 51 · Napredna · Različica: 3