CKTIS / C#
System.Index en System.Range: posities en segmenten
Bereken posities vanaf het begin of einde, controleer de grenzen van een segment en herken of je een kopie of een weergave van dezelfde gegevens krijgt.
Versie: 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];In C# 12 en .NET 8 zijn System.Index en System.Range onveranderlijke waardetypen in de naamruimte System. Ze beschrijven posities zonder gegevens of een verwijzing naar een reeks te bewaren. Index i = 1 gebruikt een impliciete conversie vanuit int en telt vanaf nul aan het begin. Index i = ^1 is gelijkwaardig aan new Index(1, fromEnd: true) en wijst het laatste element van een niet-lege reeks aan. Het voorvoegsel ^n is niet hetzelfde als a ^ b, dat bitsgewijze XOR voor gehele getallen en logische XOR voor bool berekent.
i.GetOffset(length) geeft i.Value terug of, als i.IsFromEnd waar is, length - i.Value. De methode controleert niet of daar een element staat. ^0 is de positie direct na het laatste element: geldig als grens van een bereik, maar het lezen van array[^0] veroorzaakt IndexOutOfRangeException.
Range bevat twee Index-waarden: het inclusieve begin Start en het exclusieve einde End. start..end is gelijkwaardig aan new Range(start, end). Weggelaten grenzen zijn respectievelijk 0 en ^0, dus .. beschrijft de hele reeks. Voor een gegeven lengte geeft GetOffsetAndLength(length) (Offset, Length) terug. Gelijke posities geven een leeg segment; omgekeerde grenzen of posities buiten [0, length] veroorzaken ArgumentOutOfRangeException.
Ondersteuning voor sequence[i] en sequence[range] hangt af van het doeltype. C# ondersteunt eendimensionale arrays en string. Een ander type kan een passende indexer aanbieden of voldoen aan het compilerpatroon: een toegankelijke eigenschap int Length of int Count, plus een int-indexer voor Index of Slice(int, int) voor Range. In het voorbeeld kopieert het arraysegment de elementen; het Span<T>-segment is een weergave van hetzelfde geheugen. In C# 12 mag je geen Span<T>-variabelen gebruiken in async-methoden. Dat is een beperking van ref struct, niet van Range.
Voorbeelden
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]}"));Resultaat
last=50 offset=1, length=3 copy=20, source=99, view=99
`^1` wijst `50` aan, maar `1..^1` sluit die waarde uit en bevat `20`, `30` en `40`. Schrijf je `99` via de weergave, dan wijzigt de oorspronkelijke array, maar niet de kopie.
Gerelateerde lessen
- C# · Les 51 · Gevorderd · Versie: 3