WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen