Устанавливает значение по индексу. Работает аналогично оператору [].
Синтаксис
Установить(<Индекс>, <Значение>)Полное описание, параметры и ограничения
Массив.Установить (Array.Set)
Массив (Array)
Установить (Set)
Доступен, начиная с версии 8.0.
Синтаксис:
Установить(<Индекс>, <Значение>)
Параметры:
<Индекс> (обязательный)
Тип: Число.
Индекс элемента.
<Значение> (обязательный)
Тип: Произвольный.
Устанавливаемое значение.
Описание:
Устанавливает значение по индексу. Работает аналогично оператору [].
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Применяется в случаях, когда использование оператора [] невозможно.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Изменить порядок товаров в массиве без поиска по названию
Показывает разницу между добавлением в конец, вставкой по индексу и заменой существующего значения. Исходные данные создаются прямо в коде.
Где и как запускать
Фрагмент внутри процедуры в клиентском или серверном контексте, поддерживающем Массив.
Подготовка
Создайте учебную команду или процедуру. Поместите фрагмент внутрь её тела.
Внешние файлы и объекты конфигурации не нужны: массив создаётся в памяти.
Товары = Новый Массив;
Товары.Добавить("Книга");
Товары.Добавить("Ручка");
Товары.Вставить(1, "Тетрадь");
Товары.Установить(2, "Карандаш");
Сообщить(Товары.Получить(1));
Сообщить(Товары.Количество());
Сообщить(Товары.ВГраница());
Для Каждого Товар Из Товары Цикл
Сообщить(Товар);
КонецЦикла;Разбор по шагам
Добавить помещает два значения в конец массива: они занимают индексы 0 и 1.
Вставить с индексом 1 помещает Тетрадь перед Ручка; прежняя ручка перемещается на индекс 2.
Установить заменяет значение по индексу 2, не увеличивая количество элементов.
Получить(1) возвращает Тетрадь. Количество равно 3, а ВГраница — 2, поскольку индексы начинаются с нуля.
Цикл выводит конечный порядок элементов.
Как проверить результат
Первыми сообщениями должны быть Тетрадь, 3 и 2, затем Книга, Тетрадь, Карандаш.
Замените индекс Установить на 1: количество останется 3, но изменится второй элемент.
В отладчике проверьте индексы сразу после Вставить: ранее существовавшие элементы сдвинулись.
Ожидаемый результат
Конечный массив: Книга, Тетрадь, Карандаш. Вставка меняет длину, замена — нет.
На что обратить внимание
Нельзя читать или заменять элемент с индексом, выходящим за границы массива.
Не путайте порядковый номер для пользователя (первый, второй) с индексом (0, 1).
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.