Первый шаг в 1С — абсолютно бесплатно.

Структура определение и примеры

Структура в 1С 8.3 — это объект встроенного языка, представляющий собой именованную коллекцию значений. Она состоит из пар Ключ и Значение.

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

* Значение — данные, которые хранятся под этим ключом (абсолютно любой тип: число, строка, дата, ссылка на справочник, массив или даже другая структура).

Аналогия для статьи: Представьте комод, где на каждом ящике наклеена уникальная бирка («Имя», «Возраст», «Должность»). Вы не знаете точный порядковый номер ящика, но можете мгновенно достать вещь, просто прочитав название на бирке.

Создание структуры

Существует два основных способа инициализации структуры:

Способ 1: Создание пустой структуры

Способ 2: Создание с одновременным заполнением

Ключи и значения передаются перечислением через запятую: сначала все ключи одной строкой (через запятую), а затем соответствующие им значения.

⚠️ Важно для статьи (Стандарты 1С): Согласно стандартам разработки «1С», в конструктор структуры не рекомендуется передавать более 3-х ключей, так как такой код становится трудночитаемым. Если ключей больше, лучше создавать пустую структуру и заполнять её методом Вставить().

Как вставить и добавить элемент

Для добавления новых элементов или изменения существующих используется метод Вставить().

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

Как узнать количество элементов

Для определения общего числа пар Ключ/Значение используется метод Количество().

Как обойти в цикле все элементы

Так как структура — это коллекция, ее можно перебрать с помощью цикла Для Каждого. При каждом шаге цикла система возвращает специальный объект типа КлючИЗначение, у которого есть два свойства: .Ключ и .Значение.

Как удалить элемент

Для удаления конкретного свойства по его имени используется метод Удалить(). В параметр передается строка с именем ключа.

Как очистить структуру

Если нужно полностью освободить структуру от всех элементов, не удаляя сам объект из памяти, применяется метод Очистить(). После этого структура становится пустой (количество элементов равно 0).

Как проверить, есть ли ключ в структуре (Метод Свойство)

Прямое обращение к несуществующему ключу (например, ДанныеСотрудника.Адрес) вызовет критическую ошибку программы. Чтобы этого избежать, используют метод Свойство(). Он проверяет наличие ключа и, если тот найден, может сразу записать его значение в переменную.

Разница между обращением через Точку и через Квадратные скобки

* Через точку (Структура.ИмяКлюча): Используется, когда имя ключа известно заранее на этапе написания кода.

* Через квадратные скобки (Структура[ИмяПеременной]): Незаменимо, когда имя ключа динамически вычисляется в коде или хранится в другой переменной.

Копирование структур (Нюанс с передачей по ссылке)

В 1С структуры передаются по ссылке. Если вы напишете НоваяСтруктура = СтараяСтруктура;, то изменение Новой изменит и Старую. Чтобы сделать независимую копию, используют метод ЗаполнитьЗначенияСвойств():

Определение соответствия и примеры

Соответствие в 1С 8.3 — это встроенный объект-коллекция, предназначенный для хранения пар «Ключ — Значение».Его главное отличие от Структуры заключается в том, что в качестве ключа можно использовать любой тип данных (число, ссылку, дату, массив), а не только строку, удовлетворяющую правилам идентификатора.

Ниже приведены подробные примеры и все стандартные методы работы с этой коллекцией.

Как создать соответствие

Для создания объекта используется конструктор Новый:

Как добавить элементы

Для добавления элементов используется метод Вставить(Ключ, Значение).

Как изменить значение ключа

Метод Вставить() работает по принципу «добавить или заменить». Если ключ уже существует в коллекции, его значение перезапишется.

Как получить значение по ключу

Получить значение можно с помощью квадратных скобок [] или метода Получить(Ключ).

Как узнать, есть ли соответствие (Проверить наличие ключа)

Если ключа в коллекции нет, 1С вернет значение Неопределено. Однако, если само значение ключа было Неопределено, этот способ не подойдет. Для точной проверки существует специальный метод Свойство(Ключ, НайденноеЗначение).

Как узнать количество элементов

Количество элементов (пар) в коллекции возвращает метод Количество().

Как перебрать (обойти) все элементы

Для перебора коллекции используется цикл Для каждого. На каждой итерации система возвращает объект типа КлючИЗначение, у которого есть свойства Ключ и Значение.

Как удалить элемент

Для удаления конкретной пары по её ключу используется метод Удалить(Ключ).

Как очистить все элементы

Чтобы полностью опустошить коллекцию, сохранив сам объект, вызывают метод

💡 Что еще важно знать о Соответствии (Нюансы для статьи)

* Поиск по ключу регистрозависим: Если ключом является строка, то "Ключ" и "ключ" — это два разных ключа.

* Сериализация (передача между сервером и клиентом): Соответствие можно без проблем передавать с сервера на клиент и обратно.

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

Сравнение со Структурой:

У Структуры ключ — только строка (без пробелов и спецсимволов). К её свойствам можно обращаться через точку: Структура.Имя.

У Соответствия ключ — любой тип. Обращаться через точку нельзя: Соответствие.Ключ вызовет ошибку, нужно писать только Соответствие[Ключ].

📌 Памятка для начинающих: когда выбирать Структуру, а когда Соответствие?

Чтобы у новичков не путались эти две коллекции, можно добавить в статью простую шпаргалку:

Выбирайте СТРУКТУРУ, если вам нужно передать набор параметров, где имена параметров фиксированы и вы точно знаете их по именам (например: ПараметрыОтбора = Новый Структура("Организация, Склад");). К ним удобно обращаться через точку: ПараметрыОтбора.Склад.

Выбирайте СООТВЕТСТВИЕ, если ключ заранее неизвестен, им является объект (товар, контрагент, документ, число) и вам нужно быстро находить связанные с ним данные без циклов.

Практический пример: Быстрое заполнение цен в документе

Представьте задачу: у нас есть массив товаров, и нам нужно проставить для каждого актуальную цену из регистра.

❌ Как делать НЕ надо (Типичная ошибка новичка):Искать цену запросом или методом Найти() в цикле. Из-за этого программа будет постоянно обращаться к базе данных или перебирать всю таблицу заново, что приведет к сильным зависаниям.

Как сделать правильно с помощью Соответствия:

* Мы одним запросом выбираем все нужные цены.

* Выгружаем их в Соответствие, где Ключом будет сам товар (ссылка), а Значением — его цена.

* В цикле моментально получаем цену по ключу.