Методы «Вставить()» и «ВставитьЕслиОтсутствует()» - «1С:Предприятие.Элемент». Возможности встроенного языка - Е. Ю. Хрусталёва - RutLib.com

В языке «1С:Предприятия» вставить в соответствие пару Ключ и Значение можно было только методом Вставить(). Если пара с указанным значением ключа уже существовала, то его значение заменялось на новое, в противном случае в соответствие добавлялся новый элемент.

Теперь в языке «Элемента» для вставки элементов в соответствие есть еще один полезный метод ВставитьЕслиОтсутствует(), который позволяет вставить какую-либо пару значений только в том случае, если этой пары еще нет в соответствии. Если же ключ в соответствии уже есть, то метод ВставитьЕслиОтсутствует() не будет изменять существующую пару. При выполнении проверки анализируется только значение ключа. Например:

пер С1 = {"1-й этап": 120, "2-й этап": "3 часа", "3-й этап":310}

Сообщить("%С1") //результат: {1-й этап: 120, 2-й этап: 3 часа, 3-й этап: 310}

С1.Вставить("3-й этап", 33)

Сообщить("%С1") //результат: {1-й этап: 120, 2-й этап: 3 часа, 3-й этап: 33}

С1.ВставитьЕслиОтсутствует("3-й этап", 20)

Сообщить("%С1") //результат: {1-й этап: 120, 2-й этап: 3 часа, 3-й этап: 33}

С1.ВставитьЕслиОтсутствует("4", 4)

Сообщить("%С1") //результат: {1-й этап: 120, 2-й этап: 3 часа, 3-й этап: 33, 4: 4}