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

CKTIS / C#

System.Index и System.Range: позиции и отрязъци

Научете как да изчислявате позиции от началото или края, да проверявате границите на отрязък и да различавате копие от изглед към същите данни.

Версия: C# 12 and .NET 8; later runtimes may add compatible features

Синтаксис

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

В C# 12 и .NET 8 System.Index и System.Range са неизменяеми стойностни типове в пространството от имена System. Те описват позиции, без да пазят данни или референция към последователност. Index i = 1 използва неявно преобразуване от int и брои от нула спрямо началото. Index i = ^1 е равностойно на new Index(1, fromEnd: true) и посочва последния елемент на непразна последователност. Префиксът ^n не е a ^ b, което означава побитово XOR за цели числа и логическо XOR за bool.

i.GetOffset(length) връща i.Value или, ако i.IsFromEnd е истина, length - i.Value. Методът не проверява дали на тази позиция има елемент. ^0 е позицията непосредствено след последния елемент: тя е валидна граница на диапазон, но четенето на array[^0] хвърля IndexOutOfRangeException.

Range съдържа две стойности от тип Index: включеното начало Start и изключения край End. start..end е равностойно на new Range(start, end). При пропуснати граници се използват съответно 0 и ^0, затова .. описва цялата последователност. При зададена дължина GetOffsetAndLength(length) връща двойката (Offset, Length). Еднаквите позиции дават празен отрязък; разменените граници или позициите извън [0, length] водят до ArgumentOutOfRangeException.

Поддръжката на sequence[i] и sequence[range] зависи от целевия тип. C# поддържа едномерни масиви и string. Друг тип може да предостави подходящ индексатор или да следва шаблона на компилатора: достъпно свойство int Length или int Count и индексатор с параметър int за Index или метод Slice(int, int) за Range. В примера отрязъкът от масива копира елементите, а отрязъкът от Span<T> е изглед към същата памет. В C# 12 променливи от тип Span<T> не могат да се използват в методи async; това е ограничение на ref struct, а не на Range.

Примери

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

Резултат

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

`^1` посочва `50`, но `1..^1` изключва тази стойност и включва `20`, `30` и `40`. Записването на `99` през изгледа променя изходния масив, но не и копието.

Свързани уроци

  • C# · Урок 51 · Напреднало · Версия: 3

Източници