Как удалить строку из структуры в 1С

Структура в 1С — это коллекция пар «ключ-значение», а не таблица с пронумерованными строками. Поэтому фраза «удалить строку из структуры» на практике означает удаление элемента по имени ключа. Для этого у объекта Структура есть единственный штатный метод — Удалить(), который принимает строковое имя ключа.

Частая путаница возникает из-за того, что в отладчике и в пользовательском интерфейсе структура отображается построчно: ключ слева, значение справа. Визуально это похоже на таблицу, поэтому разработчики пытаются применить к ней методы таблицы значений — Удалить(Индекс) или обход по индексу. Такой подход не сработает: у структуры нет индексов, порядок элементов не гарантирован, а обращение возможно только по ключу.

Ниже разобраны все рабочие сценарии: удаление одного элемента, удаление нескольких ключей, очистка структуры целиком, безопасное удаление с проверкой существования ключа, а также типичные ошибки и отличия от смежных коллекций — соответствия и таблицы значений.

Метод Удалить() — основной способ удаления элемента

Метод Удалить() принимает один параметр — строку с именем ключа, который нужно убрать из структуры. После вызова элемент исчезает из коллекции, а количество элементов (Количество()) уменьшается на единицу.

СтруктураДанных = Новый Структура;
СтруктураДанных.Вставить("Номенклатура", "Товар А");
СтруктураДанных.Вставить("Количество", 10);
СтруктураДанных.Вставить("Цена", 1500);

СтруктураДанных.Удалить("Цена");
// В структуре осталось 2 элемента: Номенклатура и Количество

Имя ключа чувствительно к регистру только частично: по соглашениям платформы ключи идентификаторного типа сравниваются без учёта регистра, однако полагаться на это не стоит — лучше всегда указывать ключ точно так, как он был вставлен. Лишние пробелы в начале или конце строки ключа приведут к тому, что элемент не будет найден.

Метод не возвращает значение. Если нужно получить значение перед удалением (паттерн «извлечь и убрать»), сначала прочитайте его через обращение по ключу или Свойство(), а затем вызовите Удалить().

СтруктураДанных.Удалить("Цена"); // удаление элемента по ключу

Безопасное удаление: проверка существования ключа

Если вызвать Удалить() для ключа, которого нет в структуре, платформа вызовет исключение с сообщением о том, что ключ не найден. В типовом коде, где структура формируется динамически, это частая причина падения процедур.

Безопасный шаблон — проверка через метод Свойство(). Он возвращает Истина, если ключ существует, и может одновременно вернуть значение через второй параметр:

ЗначениеКлюча = Неопределено;
Если СтруктураДанных.Свойство("Цена", ЗначениеКлюча) Тогда
// ключ есть — можно работать со значением и удалять
СтруктураДанных.Удалить("Цена");
КонецЕсли;

Альтернативный вариант — обернуть удаление в попытку, но это хуже: исключения медленнее и затрудняют отладку. Попытку оправданно использовать только когда отсутствие ключа — действительно аварийная ситуация, которую нужно залогировать.

1. 1
   Проверьте наличие ключа: СтруктураДанных.Свойство("Ключ", Значение)
2. 2
   Если ключ найден — при необходимости сохраните значение в переменную
3. 3
   Вызовите СтруктураДанных.Удалить("Ключ")
4. 4
   Проверьте результат через СтруктураДанных.Количество() или повторный вызов Свойство()

Удаление нескольких элементов и полная очистка

Удаление по списку ключей

Если нужно убрать несколько элементов, удобно хранить их имена в массиве и проходить циклом с проверкой. Удалять элементы внутри прямого обхода структуры циклом Для Каждого нельзя — модификация коллекции во время итерации приводит к ошибке.

КлючиКУдалению = Новый Массив;
КлючиКУдалению.Добавить("ВременноеПоле1");
КлючиКУдалению.Добавить("ВременноеПоле2");

Для Каждого ИмяКлюча Из КлючиКУдалению Цикл
Если СтруктураДанных.Свойство(ИмяКлюча) Тогда
СтруктураДанных.Удалить(ИмяКлюча);
КонецЕсли;
КонецЦикла;

Удаление по условию на значение

Когда критерий удаления — не имя ключа, а значение (например, убрать все пустые элементы), сначала соберите ключи в отдельный массив, затем удаляйте:

КлючиКУдалению = Новый Массив;
Для Каждого Элемент Из СтруктураДанных Цикл
Если Не ЗначениеЗаполнено(Элемент.Значение) Тогда
КлючиКУдалению.Добавить(Элемент.Ключ);
КонецЕсли;
КонецЦикла;

Для Каждого ИмяКлюча Из КлючиКУдалению Цикл
СтруктураДанных.Удалить(ИмяКлюча);
КонецЦикла;

Полная очистка

Штатного метода Очистить() у структуры нет. Чтобы удалить все элементы, либо пересоздайте объект (СтруктураДанных = Новый Структура;), либо соберите все ключи в массив и удалите их циклом по шаблону выше. Пересоздание проще и быстрее, но не подходит, если на исходную структуру есть внешние ссылки — тогда другие переменные продолжат указывать на старый объект.

Отличия структуры от соответствия и таблицы значений

Выбор коллекции влияет на то, как именно удаляются данные. Соответствие внешне похоже на структуру, но ключом может быть любой тип, а не только строка-идентификатор. Таблица значений — принципиально другой объект с индексами и строками-объектами.

Если вам нужно удалять «строки» по номеру или по сложному условию отбора, структура — неподходящий инструмент. Используйте таблицу значений с методами НайтиСтроки() и Удалить() либо соответствие, если важен произвольный тип ключа.

Типичные ошибки при удалении из структуры

Первая группа ошибок связана с неверным пониманием природы коллекции: попытка обратиться по индексу (Структура[0]), использование Количество() как верхней границы цикла со счётчиком, ожидание стабильного порядка элементов. Всё это работает для массивов и таблиц, но не для структуры.

Вторая группа — ошибки именования ключей. Ключ с пробелом, кириллический ключ с опечаткой, ключ, переданный с другим регистром в нестандартном сценарии, — всё это приводит либо к исключению, либо к тихому пропуску удаления, если используется проверка Свойство() без логирования ветки «ключ не найден».

Третья группа — работа с копиями. Структура передаётся по ссылке, поэтому удаление элемента внутри вызванной процедуры изменит структуру и у вызывающего кода. Если это нежелательно, создайте копию через обход и вставку в новую структуру.

Проверка результата и отладка

После удаления убедитесь, что элемент действительно исчез. Самый надёжный способ — повторный вызов Свойство("Ключ"): он должен вернуть Ложь. Дополнительно сравните Количество() до и после операции.

В отладчике структура раскрывается как список пар «ключ — значение». Если после удаления элемент всё ещё виден, чаще всего причина в том, что изменялась другая копия структуры (например, созданная внутри функции) или удаление происходило по ключу с опечаткой.

Для массовых операций полезно логировать факт удаления: записывайте в журнал или выводите в сообщение имя удалённого ключа и оставшееся количество элементов. Это упрощает поиск причин, когда итоговая структура не совпадает с ожидаемой.

Когда структуру лучше заменить другой коллекцией

Структура оптимальна для передачи именованных параметров и небольших наборов данных с фиксированным составом полей. Если сценарий предполагает частое удаление, фильтрацию, сортировку или обход по индексу, затраты на обходные пути превысят выгоду от простоты структуры.

Признаки того, что пора переходить на таблицу значений: в коде появляются массивы «ключей к удалению», сложные условия отбора, потребность в построчном отображении пользователю. Признаки перехода на соответствие — необходимость использовать в качестве ключа ссылки, числа или другие нестроковые значения.

Частые вопросы