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