Массив
Стд::Коллекции::Массив<ТипЭлемента> Базовые типы: Коллекция, Обходимое, Объект, ЧитаемаяКоллекция, ЧитаемыйМассив |
ТипЭлемента: Тип элементов коллекции |
Иерархия типа
Изменяемая коллекция, в которой каждому элементу соответствует свой индекс. Поддерживает дубликаты элементов.
- ItemType - Тип элементов коллекции
Индексация начинается с 0. Методы, принимающие диапазоны значений, не включают верхний индекс. Числовое значение индекса должно лежать в диапазоне 0 .. 2147483647. При работе методов с индексами могут быть выброшены исключения:
- ИсключениеИндексВнеГраниц - при выходе индекса за допустимый диапазон,
- ИсключениеНедопустимыйАргумент - если индекс начальный индекс >= конечного индекса.
Сравнение структурное:
- массивы считаются равными, если их размер совпадает, а так же равны элементы на соответствующих индексах.
- типы массивов при этом не учитываются.
Обход в цикле:
Возвращает элементы массива в порядке следования индексов.
Тип: ItemType
Литералы
Синтаксис (краткий): [ элемент_0, ..., элемент_n ]
, тип элементов массива выводится автоматически (если возможно). Синтаксис (с указанием типов элементов): \<ИмяТипа\>[ элемент_0, ..., элемент_n ]
.
Операция []
[Ключ: Число]: ItemType |
Изменяемый |
Возвращает или присваивает элемент по указанному индексу.
Конструкторы
Массив
Массив()
Перегрузка: Массив(Обходимое: Обходимое<ItemType>) |
Создает пустой массив.
Примеры
знч Массив = новый Массив<Число>()
Массив
Массив(Обходимое: Обходимое<ItemType>)
Перегрузка: Массив() |
Конструктор копирования. Копирует элементы переданного Обходимое
в новый массив.
Методы
Вставить
Вставить(
Индекс: Число,
Элемент: ItemType)
Вставляет значение Элемент
в массив по указанному индексу Индекс
.
ВставитьВсе
Вставляет все элементы Обходимое
начиная с индекса Индекс
и далее.
Развернуть
Меняет местами элементы массива, находящиеся в диапазоне индексов, начиная с От
до До
, не включая конечный. Значением по умолчанию конечного индекса До
является размер массива.
Сортировать
Сортирует массив, используя Компаратор
для сравнения элеметов, в заданном диапазоне индексов с От
до До
, не включая конечный. Значением по умолчанию конечного индекса До
является размер массива.
Примеры
// Сортировка массива структур по числовому полю
знч Структуры = [новый МояСтруктура(ЧисловоеПоле = 42), новый МояСтруктура(ЧисловоеПоле = 100500)]
Структуры.СортироватьПо((Структура1, Структура2) -> Структура1.ЧисловоеПоле - Структура2.ЧисловоеПоле)
См. также
СортироватьПо
Сортирует массив, используя Извлекатель
для сравнения элеметов, в заданном диапазоне индексов с От
до До
, не включая конечный. Значением по умолчанию конечного индекса До
является размер массива.
Извлекатель
- функция, применяющаяся к каждому элементу, возвращающая характеристику, которая непосредственно будет сравниваться с характеристиками остальных значений для упорядочивания. Например для структуры извлекатель может возвращать свойство, по которому сравниваются структуры.
Примеры
// Сортировка массива чисел, извлекатель возвращает элементы массива, так как Число является Сравнимое
знч Числа = [5, 1]
Числа.СортироватьПо(элемент -> элемент)
// Сортировка массива структур по числовому полю
знч Структуры = [новый МояСтруктура(ЧисловоеПоле = 42), новый МояСтруктура(ЧисловоеПоле = 100500)]
Структуры.СортироватьПо(Структура -> Структура.ЧисловоеПоле)
Удалить
Удаляет элемент Элемент
из массива. Если ТолькоПервый
истина, то будет удалено только первое вхождение элемента в массив. Возвращает признак того, что массив был изменен.
УдалитьДиапазон
Удаляет значения из массива в заданном диапазоне индексов с От
до До
, не включая конечный. Значением по умолчанию конечного индекса До
является размер массива.
УдалитьПоИндексу
УдалитьПоИндексу(Индекс: Число): ItemType
Удаляет элемент по индексу Индекс
и возвращает его.
Установить
Установить(
Индекс: Число,
Элемент: ItemType)
Устанавливает значение Элемент
в массиве по указанному индексу Индекс