Удаляет элемент структуры с заданным ключом.
Синтаксис
Удалить(<Ключ>)Примеры платформы
Отбор.Удалить("Дата");Полное описание, параметры и ограничения
Структура.Удалить (Structure.Delete)
Структура (Structure)
Удалить (Delete)
Доступен, начиная с версии 8.0.
Синтаксис:
Удалить(<Ключ>)
Параметры:
<Ключ> (обязательный)
Тип: Строка.
Ключ удаляемого элемента.
Описание:
Удаляет элемент структуры с заданным ключом.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Пример:
Отбор.Удалить("Дата");
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Прочитать необязательную настройку и сохранить значение по умолчанию
Структура хранит настройки по именам. Метод Свойство позволяет отличить отсутствующую настройку от существующей со значением 0.
Где и как запускать
Фрагмент внутри учебной процедуры; внешних объектов нет.
Подготовка
Создайте команду или процедуру для запуска примера.
Оставьте исходное Количество равным 0 в структуре, чтобы увидеть разницу между отсутствием и нулевым значением.
Настройки = Новый Структура;
Настройки.Вставить("Название", "Книга");
Настройки.Вставить("Количество", 0);
Количество = 1;
Если Не Настройки.Свойство("Количество", Количество) Тогда
Количество = 1;
КонецЕсли;
Сообщить(Количество);
Сообщить(Настройки.Количество());
Настройки.Удалить("Название");
Сообщить(Настройки.Количество());
Настройки.Очистить();
Сообщить(Настройки.Количество());Разбор по шагам
Создаём структуру с двумя именованными свойствами.
Метод Свойство возвращает признак наличия поля и передаёт его значение во второй аргумент.
Количество 0 сохраняется как осмысленная настройка. Значение 1 выбирается только при отсутствии поля.
Количество() возвращает число свойств структуры, а не значение поля Количество.
Удалить убирает одно свойство, Очистить — все свойства.
Как проверить результат
В исходном варианте ожидаются сообщения 0, 2, 1 и 0.
Уберите строку Вставить для Количество: первое сообщение станет 1.
Измените сохранённое количество на 3: первое сообщение должно стать 3 без изменения числа свойств.
Ожидаемый результат
Настройки читаются с явным правилом выбора значения по умолчанию; ноль не теряется.
На что обратить внимание
Имя свойства структуры должно быть допустимым идентификатором встроенного языка. Для произвольных строковых ключей используйте Соответствие.
Точка и круглые скобки различают поле Количество и метод Количество().
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.