СписокЗначений
Метод ВставитьЗначение()

Метод вставляет значение в указанную позицию списка

Синтаксис

Метод ВставитьЗначение() имеет следующий синтаксис:

СписокЗначений.ВставитьЗначение(Позиция, Значение, [Представление] [, Количество = 1])

А также альтернативный англоязычный синтаксис:

ValueList.InsertValue(Position, Value, [Name] [, Count = 1])

Параметры

Описание параметров метода ВставитьЗначение()

Имя параметра	Тип	Описание
Позиция*	Число	Целочисленный номер позиции вставляемого значения в списке. Должен находиться в пределах от 1 до РазмерСписка() + 1
Значение*	Произвольный	Вставляемое значение
Представление	Строка	Строковое представление вставляемого значения. Если параметр опущен, берется стандартное представление значения или объекта
Количество	Число	Количество повторений вставки данного значения. Значение по умолчанию = 1
* — обязательный параметр

Описание

Метод ВставитьЗначение() выполняет вставку значения и его представления в указанную позицию списка. Если опустить параметр Представление, то представление значения будет сформировано автоматически путем неявного преобразования параметра Значение к типу Строка.

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

Пример использования

Пример кода с использованием процедуры ВставитьЗначение()

СписокЗначений = СоздатьОбъект("СписокЗначений");
СписокЗначений.ДобавитьЗначение(1);
СписокЗначений.ДобавитьЗначение(2);
СписокЗначений.ДобавитьЗначение(3);

//вставка значения в середину списка
СписокЗначений.ВставитьЗначение(2, 10);

//вставка значения в конец списка	
СписокЗначений.ВставитьЗначение(СписокЗначений.РазмерСписка() + 1, 4);

Читайте также:

Объект СписокЗначений

СписокЗначений.ДобавитьЗначение()

Поделиться страницей в соц.сетях