Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

System.Index et System.Range : positions et tranches

Calculez une position depuis le début ou la fin, vérifiez les bornes d’une tranche et déterminez si elle copie les éléments ou fournit une vue.

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

Syntaxe

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

En C# 12 et .NET 8, System.Index et System.Range sont des types valeur immuables de l’espace de noms System. Ils décrivent des positions sans conserver les données ni de référence à une séquence. Index i = 1 utilise une conversion implicite depuis int et compte à partir de zéro depuis le début. Index i = ^1 équivaut à new Index(1, fromEnd: true) et désigne le dernier élément d’une séquence non vide. Le préfixe ^n est distinct de a ^ b, qui calcule un XOR bit à bit pour les entiers et un XOR logique pour bool.

i.GetOffset(length) renvoie i.Value ou, si i.IsFromEnd vaut vrai, length - i.Value. La méthode ne vérifie pas qu’un élément existe à cette position. ^0 est la position juste après le dernier élément : c’est une borne valide pour une plage, mais lire array[^0] lève IndexOutOfRangeException.

Range contient deux valeurs Index : le début inclus Start et la fin exclue End. start..end équivaut à new Range(start, end). Les bornes omises valent respectivement 0 et ^0 ; .. désigne donc toute la séquence. Pour une longueur donnée, GetOffsetAndLength(length) renvoie (Offset, Length). Des positions égales donnent une tranche vide ; des bornes inversées ou des positions hors de [0, length] provoquent ArgumentOutOfRangeException.

La prise en charge de sequence[i] et sequence[range] dépend du type cible. C# prend en charge les tableaux unidimensionnels et string. Un autre type peut fournir un indexeur adapté ou suivre le modèle reconnu par le compilateur : une propriété accessible int Length ou int Count, avec un indexeur int pour Index ou Slice(int, int) pour Range. Dans l’exemple, la tranche du tableau copie les éléments, tandis que celle de Span<T> est une vue sur la même mémoire. En C# 12, les variables Span<T> sont interdites dans les méthodes async : c’est une restriction de ref struct, pas de Range.

Exemples

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

Résultat

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

`^1` désigne `50`, mais `1..^1` l’exclut et contient `20`, `30` et `40`. Écrire `99` via la vue modifie le tableau source, mais pas la copie.

Leçons associées

  • C# · Leçon 51 · Avancé · Version : 3

Sources