Метод вставляет значение в указанную позицию списка
Синтаксис
Метод ВставитьЗначение()
имеет следующий синтаксис:
СписокЗначений.ВставитьЗначение(Позиция, Значение, [Представление] [, Количество = 1])
А также альтернативный англоязычный синтаксис:
ValueList.InsertValue(Position, Value, [Name] [, Count = 1])
Параметры
Описание параметров метода ВставитьЗначение()
Имя параметра | Тип | Описание |
---|---|---|
Позиция* | Число | Целочисленный номер позиции вставляемого значения в списке. Должен находиться в пределах от 1 до РазмерСписка() + 1 |
Значение* | Произвольный | Вставляемое значение |
Представление | Строка | Строковое представление вставляемого значения. Если параметр опущен, берется стандартное представление значения или объекта |
Количество | Число | Количество повторений вставки данного значения. Значение по умолчанию = 1 |
* — обязательный параметр |
Описание
Метод ВставитьЗначение()
выполняет вставку значения и его представления в указанную позицию списка. Если опустить параметр Представление
, то представление значения будет сформировано автоматически путем неявного преобразования параметра Значение
к типу Строка.
С помощью данного метода можно выполнить вставку значения в произвольное место списка, и даже в его конец: для этого в параметре Позиция
необходимо указать значение, на единицу большее размера списка.
Пример использования
Пример кода с использованием процедуры ВставитьЗначение()
СписокЗначений = СоздатьОбъект("СписокЗначений"); СписокЗначений.ДобавитьЗначение(1); СписокЗначений.ДобавитьЗначение(2); СписокЗначений.ДобавитьЗначение(3); //вставка значения в середину списка СписокЗначений.ВставитьЗначение(2, 10); //вставка значения в конец списка СписокЗначений.ВставитьЗначение(СписокЗначений.РазмерСписка() + 1, 4);
Читайте также:
СписокЗначений.ДобавитьЗначение()