Руководство по встроенному языку » 

Работаем со структурой программно

Структура — это программная коллекция (объект встроенного языка), содержащая набор элементов Ключ и Значение

Ключ является строковым идентификатором, по которому можно получать или устанавливать Значение. Идентификатор ключа должен содержать только буквы, цифры и символы подчеркивания, и не может начинаться с цифры.

Структура используется в алгоритмах, написанных на встроенном языке 1С:Предприятие 8, для хранения значений, привязанных к имени.

Элемент структуры

Каждый элемент структуры является программным объектом КлючИЗначение встроенного языка и содержит следующие свойства:

  • Ключ (Строка) — строковый идентификатор
  • Значение (Произвольный тип) — произвольное значение

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

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

Структура = Новый Структура;

Второй способ — использование конструктора, который вместе с созданием структуры выполняет ее инициализацию. Например, так:

Структура = Новый Структура("Код,Наименование");

Все созданные свойства структуры будут содержать значение Неопределено. Для того, чтобы задать другое значение по умолчанию, нужно передать его конструктору (последовательность значений должны совпадать с последовательностью имен свойств):

Структура = Новый Структура("Код,Наименование", 100, "Стул деревянный");

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

Структура.Вставить("Код", 100);
Структура.Вставить("Наименование", "Стул деревянный");

Обращение к свойствам структуры

Для доступа к значениям структуры применяется операция разыменования: указывается имя переменной, объявленной как структура, а затем ключ значения через точку. Разыменование возможно как слева от оператора присваивания, так и справа:

Структура.Код = "200";
Структура.Наименование = Структура.Код;

Перебор элементов структуры

Для перебора (обхода) всех элементов структуры используется оператор цикла Для Каждого:

Для каждого Элемент Из Структура Цикл
	Сообщить("" + Элемент.Ключ = " = " + Элемент.Значение);
КонецЦикла;

Методы объекта Структура

Вставить() добавляет новое свойство в структуру
Количество() возвращает количество элементов в структуре
Очистить() удаляет все элементы из структуры
Свойство() реализует безопасное чтение значения свойства
Удалить() удаляет свойство структуры по имени