Массив

Иерархия типа

Изменяемая коллекция, в которой каждому элементу соответствует свой индекс. Поддерживает дубликаты элементов.

• ItemType - Тип элементов коллекции

Индексация начинается с 0. Методы, принимающие диапазоны значений, не включают верхний индекс. Числовое значение индекса должно лежать в диапазоне 0 .. 2147483647. При работе методов с индексами могут быть выброшены исключения:

• ИсключениеИндексВнеГраниц - при выходе индекса за допустимый диапазон,
• ИсключениеНедопустимыйАргумент - если индекс начальный индекс >= конечного индекса.

Сравнение структурное:

• массивы считаются равными, если их размер совпадает, а так же равны элементы на соответствующих индексах.
• типы массивов при этом не учитываются.

Обход в цикле:

Возвращает элементы массива в порядке следования индексов.

Тип: ItemType

Литералы

Синтаксис (краткий): [ элемент_0, ..., элемент_n ], тип элементов массива выводится автоматически (если возможно). Синтаксис (с указанием типов элементов): \<ИмяТипа\>[ элемент_0, ..., элемент_n ].

Операция []

Возвращает или присваивает элемент по указанному индексу.

Конструкторы

Массив

Массив()

Создает пустой массив.

Примеры

знч Массив = новый Массив<Число>()

Массив

Массив(Обходимое: Обходимое<ItemType>)

Конструктор копирования. Копирует элементы переданного Обходимое в новый массив.

Методы

Вставить

Вставить(
  Индекс: Число,
  Элемент: ItemType)

Вставляет значение Элемент в массив по указанному индексу Индекс.

ВставитьВсе

ВставитьВсе(
  Индекс: Число,
  Обходимое: Обходимое<ItemType>)

Вставляет все элементы Обходимое начиная с индекса Индекс и далее.

Развернуть

Развернуть(
  От: Число = 0,
  До: Число)

Меняет местами элементы массива, находящиеся в диапазоне индексов, начиная с От до До, не включая конечный. Значением по умолчанию конечного индекса До является размер массива.

Сортировать

Сортировать(
  Компаратор: (ItemType, ItemType)->Число,
  От: Число = 0,
  До: Число)

Сортирует массив, используя Компаратор для сравнения элеметов, в заданном диапазоне индексов с От до До, не включая конечный. Значением по умолчанию конечного индекса До является размер массива.

Примеры

// Сортировка массива структур по числовому полю
знч Структуры = [новый МояСтруктура(ЧисловоеПоле = 42), новый МояСтруктура(ЧисловоеПоле = 100500)]
Структуры.СортироватьПо((Структура1, Структура2) -> Структура1.ЧисловоеПоле - Структура2.ЧисловоеПоле)

См. также

Сравнить

СортироватьПо

СортироватьПо(
  Извлекатель: (ItemType)->Сравнимое<неизвестно>,
  Порядок: Порядок = Порядок.ПоВозрастанию,
  От: Число = 0,
  До: Число)

Сортирует массив, используя Извлекатель для сравнения элеметов, в заданном диапазоне индексов с От до До, не включая конечный. Значением по умолчанию конечного индекса До является размер массива.

Извлекатель - функция, применяющаяся к каждому элементу, возвращающая характеристику, которая непосредственно будет сравниваться с характеристиками остальных значений для упорядочивания. Например для структуры извлекатель может возвращать свойство, по которому сравниваются структуры.

Примеры

// Сортировка массива чисел, извлекатель возвращает элементы массива, так как Число является Сравнимое
знч Числа = [5, 1]
Числа.СортироватьПо(элемент -> элемент)

// Сортировка массива структур по числовому полю
знч Структуры = [новый МояСтруктура(ЧисловоеПоле = 42), новый МояСтруктура(ЧисловоеПоле = 100500)]
Структуры.СортироватьПо(Структура -> Структура.ЧисловоеПоле)

Удалить

Удалить(
  Элемент: ItemType,
  ТолькоПервый: Булево
): Булево

Удаляет элемент Элемент из массива. Если ТолькоПервый истина, то будет удалено только первое вхождение элемента в массив. Возвращает признак того, что массив был изменен.

УдалитьДиапазон

УдалитьДиапазон(
  От: Число,
  До: Число)

Удаляет значения из массива в заданном диапазоне индексов с От до До, не включая конечный. Значением по умолчанию конечного индекса До является размер массива.

УдалитьПоИндексу

УдалитьПоИндексу(Индекс: Число): ItemType

Удаляет элемент по индексу Индекс и возвращает его.

Установить

Установить(
  Индекс: Число,
  Элемент: ItemType)

Устанавливает значение Элемент в массиве по указанному индексу Индекс

Список унаследованных методов

Коллекция

Обходимое

Объект

ЧитаемаяКоллекция

ЧитаемыйМассив