База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници