CKTIS / C#
System.Index et System.Range — indices et plages
System.Index décrit une position comptée depuis le début ou la fin d’une séquence, tandis que System.Range décrit un intervalle dont le début est inclus et la fin exclue. Les opérateurs ^ et .. simplifient l’accès aux éléments et la sélection de plages ; le coût et le partage des données dépendent du type de séquence.
Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
Index last = ^1; Range middle = 1..^1; var item = sequence[last]; var slice = sequence[middle];System.Index et System.Range sont des types valeur immuables qui prennent en charge l’indexation et la sélection de plages depuis C# 8. Ils sont disponibles dans .NET 10 ; le réglage du dépôt LangVersion=preview n’est pas nécessaire pour cette fonctionnalité. Ils stockent des descriptions de positions ou d’intervalles, et non la séquence elle-même ou ses éléments.
Index stocke Value et IsFromEnd. Un int ordinaire non négatif est implicitement converti en indice compté depuis le début. ^n signifie la position Length - n : ^1 désigne le dernier élément d’une séquence non vide, tandis que ^0 est la limite juste après la fin. Par conséquent, values[^0] déclenche une exception. Une valeur négative passée au constructeur Index ou convertie depuis int provoque ArgumentOutOfRangeException. GetOffset(length) calcule un décalage, mais ne vérifie pas qu’il désigne un élément existant.
Range contient les indices Start et End. L’expression a..b inclut le début, mais exclut la fin ; 1..^1 omet le premier et le dernier élément. Les limites omises prennent par défaut les valeurs 0 et ^0 : ..b, a.. et ... GetOffsetAndLength(length) renvoie un décalage et un nombre d’éléments. La méthode déclenche ArgumentOutOfRangeException si les limites sont en dehors de 0..length ou si le début se situe après la fin. Des limites égales décrivent une plage vide, et non un intervalle inversé.
Les tableaux à une dimension, string, Span<T> et ReadOnlySpan<T> prennent en charge cette syntaxe. Implémenter uniquement IEnumerable<T> ne suffit pas : il faut des indexeurs adaptés ou un modèle reconnu par le compilateur. Une plage de tableau crée une copie superficielle des éléments ; les objets référencés par les éléments de type référence peuvent toutefois rester partagés. Une plage de Span<T> ou de ReadOnlySpan<T> est une vue sur la même mémoire, sans copie des éléments.
Exemples
using System;
internal static class Program
{
private static void Main()
{
int[] values = { 10, 20, 30, 40, 50 };
Index last = ^1;
Range middle = 1..^1;
int[] copy = values[middle];
copy[0] = 99;
Console.WriteLine(values[last]);
Console.WriteLine(string.Join(",", copy));
Console.WriteLine(values[1]);
var (offset, length) = middle.GetOffsetAndLength(values.Length);
Console.WriteLine($"{offset}:{length}");
}
}Résultat
50 99,30,40 20 1:3
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.