CKTIS / C#
System.Index en System.Range — indices en bereiken
System.Index beschrijft een positie die vanaf het begin of einde van een reeks wordt geteld. System.Range beschrijft een interval waarin het begin is inbegrepen en het einde is uitgesloten. De operatoren ^ en .. vereenvoudigen toegang tot elementen en het selecteren van bereiken; de kosten en het delen van gegevens hangen af van het type reeks.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
Index last = ^1; Range middle = 1..^1; var item = sequence[last]; var slice = sequence[middle];System.Index en System.Range zijn onveranderlijke waardetypen die sinds C# 8 indexering en bereikselectie ondersteunen. Ze zijn beschikbaar in .NET 10; voor deze functie is de repository-instelling LangVersion=preview niet nodig. Ze slaan beschrijvingen van posities of intervallen op, niet de reeks zelf of de elementen ervan.
Index slaat Value en IsFromEnd op. Een gewone niet-negatieve int wordt impliciet omgezet in een index vanaf het begin. ^n betekent positie Length - n: ^1 duidt het laatste element van een niet-lege reeks aan, terwijl ^0 de grens direct na het einde is. Daarom veroorzaakt values[^0] een uitzondering. Een negatieve waarde die aan de Index-constructor wordt doorgegeven of vanuit int wordt omgezet, veroorzaakt ArgumentOutOfRangeException. GetOffset(length) berekent een offset, maar controleert niet of die een bestaand element aanduidt.
Range bevat de indices Start en End. De expressie a..b neemt het begin wel en het einde niet mee; 1..^1 laat het eerste en laatste element weg. Weggelaten grenzen hebben standaard de waarden 0 en ^0: ..b, a.. en ... GetOffsetAndLength(length) geeft een offset en het aantal elementen terug. De methode veroorzaakt ArgumentOutOfRangeException als de grenzen buiten 0..length vallen of het begin na het einde ligt. Gelijke grenzen beschrijven een leeg bereik, geen omgekeerd interval.
Eendimensionale arrays, string, Span<T> en ReadOnlySpan<T> ondersteunen deze syntaxis. Alleen IEnumerable<T> implementeren is niet voldoende: er zijn geschikte indexers of een door de compiler herkend patroon nodig. Een arraybereik maakt een oppervlakkige kopie van de elementen; objecten waarnaar elementen van een referentietype verwijzen, kunnen nog steeds worden gedeeld. Een bereik van Span<T> of ReadOnlySpan<T> is een weergave van hetzelfde geheugen, zonder de elementen te kopiëren.
Voorbeelden
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}");
}
}Resultaat
50 99,30,40 20 1:3
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.