CKTIS / C#
System.Index und System.Range: Positionen und Ausschnitte
Berechne Positionen vom Anfang oder Ende, prüfe Bereichsgrenzen und erkenne, ob ein Ausschnitt eine Kopie oder eine Sicht auf dieselben Daten ist.
Version: 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 und .NET 8 sind System.Index und System.Range unveränderliche Werttypen im Namespace System. Sie beschreiben Positionen, ohne Daten oder einen Verweis auf eine Sequenz zu speichern. Index i = 1 verwendet eine implizite Konvertierung von int und zählt vom Anfang ab null. Index i = ^1 entspricht new Index(1, fromEnd: true) und bezeichnet das letzte Element einer nicht leeren Sequenz. Das Präfix ^n ist nicht a ^ b: Letzteres berechnet ein bitweises XOR für Ganzzahlen und ein logisches XOR für bool.
i.GetOffset(length) gibt i.Value zurück oder, falls i.IsFromEnd wahr ist, length - i.Value. Die Methode prüft nicht, ob an dieser Position ein Element liegt. ^0 liegt direkt hinter dem letzten Element: als Bereichsgrenze gültig, beim Lesen von array[^0] aber Auslöser einer IndexOutOfRangeException.
Range speichert zwei Index-Werte: den inklusiven Anfang Start und das exklusive Ende End. start..end entspricht new Range(start, end). Fehlende Grenzen werden durch 0 beziehungsweise ^0 ersetzt; .. beschreibt also die gesamte Sequenz. Für eine gegebene Länge liefert GetOffsetAndLength(length) (Offset, Length). Gleiche Offsets ergeben einen leeren Ausschnitt; vertauschte Grenzen oder Offsets außerhalb von [0, length] führen zu ArgumentOutOfRangeException.
Ob sequence[i] und sequence[range] unterstützt werden, hängt vom Zieltyp ab. C# unterstützt eindimensionale Arrays und string. Andere Typen können einen passenden Indexer anbieten oder das Compilermuster erfüllen: eine zugängliche Eigenschaft int Length oder int Count und dazu einen int-Indexer für Index oder Slice(int, int) für Range. Im Beispiel kopiert der Arrayausschnitt Elemente; der Span<T>-Ausschnitt ist eine Sicht auf denselben Speicher. In C# 12 sind Span<T>-Variablen in async-Methoden nicht zulässig. Das ist eine Einschränkung von ref struct, nicht von Range.
Beispiele
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]}"));Ergebnis
last=50 offset=1, length=3 copy=20, source=99, view=99
`^1` wählt `50` aus. Der Bereich `1..^1` schließt diesen Wert aus und enthält `20`, `30` und `40`. Wer über die Sicht `99` schreibt, ändert das ursprüngliche Array, aber nicht die Kopie.
Zugehörige Lektionen
- C# · Lektion 51 · Fortgeschritten · Version: 3