0

Метод УстановитьЗначение()

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

Синтаксис

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

УстановитьЗначение(Позиция, Значение, [Представление] [, Количество = 1])

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

SetValue(Position, Value, [Name] [, Count = 1])

Параметры

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

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

Описание

Метод УстановитьЗначение() выполняет установку значения и его представления в заданной позиции списка значений. Также, метод позволяет установить эти же значение и представление в последующих элементах списка. Для этого достаточно указать в параметре Количество нужное число повторений. При этом не происходит сдвига элементов списка значений, а происходит замена их значений и представлений на заданные.

В случае, если Вы ошиблись и указали позицию вне разрешенного диапазона: от 1 до РазмерСписка() + 1, будет выдана ошибка времени выполнения: «Индекс не входит в границы списка значений»

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

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

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

//после инициализации список содержит:
//	Один
//	Два
//	Три

//теперь, с первой по третью позицию установим значение "Два"
Список.УстановитьЗначение(1, 2, "Два", 3);

//теперь список содержит:
//	Два
//	Два
//	Два

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

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

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

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *