Удаляет все элементы соответствия.
Синтаксис
Очистить()Примеры платформы
ПараметрыОбработки.Очистить();Полное описание, параметры и ограничения
Соответствие.Очистить (Map.Clear)
Соответствие (Map)
Очистить (Clear)
Доступен, начиная с версии 8.0.
Синтаксис:
Очистить()
Описание:
Удаляет все элементы соответствия.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Пример:
ПараметрыОбработки.Очистить();
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Хранить и обновлять цены по кодам товаров
Ключи содержат дефис, поэтому используется Соответствие. Повторная вставка по существующему ключу обновляет цену, а не добавляет второй такой ключ.
Где и как запускать
Фрагмент внутри учебной процедуры, без записи в информационную базу.
Подготовка
Поместите код внутрь учебной команды или процедуры.
Коды Товар-001 и Товар-002 являются строками примера, а не ссылками на справочник.
Цены = Новый Соответствие;
Цены.Вставить("Товар-001", 150);
Цены.Вставить("Товар-002", 220);
Цены.Вставить("Товар-001", 175);
Сообщить(Цены.Получить("Товар-001"));
Сообщить(Цены.Количество());
Цены.Удалить("Товар-002");
Для Каждого Пара Из Цены Цикл
Сообщить(Пара.Ключ + ": " + Строка(Пара.Значение));
КонецЦикла;
Цены.Очистить();
Сообщить(Цены.Количество());Разбор по шагам
Создаём две пары ключ–значение.
Вставить с уже существующим ключом меняет цену на 175.
Получить читает цену, Количество показывает число ключей: их по-прежнему два.
Удаляем второй ключ. В цикле каждый элемент является парой с полями Ключ и Значение.
Очистить удаляет все пары из учебного соответствия.
Как проверить результат
Первые сообщения: 175 и 2. При обходе остаётся Товар-001: 175, после очистки выводится 0.
Замените ключ последнего Вставить на Товар-003: число пар станет 3.
Проверьте Получить для отсутствующего ключа в отладчике: возвращается Неопределено.
Ожидаемый результат
Цены доступны по коду, повторная вставка обновляет существующее значение.
На что обратить внимание
Получить возвращает Неопределено и для отсутствующего ключа, и когда это значение было сохранено явно. Если различие важно, храните дополнительный признак.
Не используйте порядок обхода соответствия как порядок товаров в документе.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.