CKTIS / C#
System.Index и System.Range — индекси и диапазони
System.Index описва позиция, броена от началото или края на последователност, а System.Range описва интервал с включено начало и изключен край. Операторите ^ и .. улесняват достъпа до елементи и избора на диапазони; разходите и споделянето на данни зависят от вида на последователността.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
Index last = ^1; Range middle = 1..^1; var item = sequence[last]; var slice = sequence[middle];System.Index и System.Range са неизменяеми стойностни типове, които поддържат индексиране и избор на диапазони от C# 8. Налични са в .NET 10; настройката на хранилището LangVersion=preview не е необходима за тази функционалност. Те съхраняват описания на позиции или интервали, а не самата последователност или елементите ѝ.
Index съхранява Value и IsFromEnd. Обикновен неотрицателен int се преобразува неявно в индекс, броен от началото. ^n означава позиция Length - n: ^1 посочва последния елемент на непразна последователност, докато ^0 е границата непосредствено след края. Затова values[^0] предизвиква изключение. Отрицателна стойност, подадена на конструктора Index или преобразувана от int, причинява ArgumentOutOfRangeException. GetOffset(length) изчислява отместване, но не проверява дали то посочва съществуващ елемент.
Range съдържа индексите Start и End. Изразът a..b включва началото, но изключва края; 1..^1 пропуска първия и последния елемент. Пропуснатите граници по подразбиране са 0 и ^0: ..b, a.. и ... GetOffsetAndLength(length) връща отместване и брой елементи. Предизвиква ArgumentOutOfRangeException, ако границите са извън 0..length или началото е след края. Равните граници описват празен срез, а не обърнат интервал.
Едномерните масиви, string, Span<T> и ReadOnlySpan<T> поддържат този синтаксис. Само имплементирането на IEnumerable<T> не е достатъчно: нужни са подходящи индексатори или шаблон, разпознаван от компилатора. Срезът на масив създава плитко копие на елементите; обектите, към които сочат елементите от референтен тип, все пак могат да бъдат споделени. Срезът на Span<T> или ReadOnlySpan<T> е изглед към същата памет, без копиране на елементите.
Примери
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}");
}
}Резултат
50 99,30,40 20 1:3
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.