1C-Code → Основы 1С → Коллекции: где хранить много значений

Коллекции: где хранить много значений

Массив, соответствие, структура и таблица значений — четыре инструмента и правило, как выбрать нужный.

Глава 10 из 36 · чтение примерно 30 минут

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

Для этого есть коллекции. Их в 1С четыре основных, и выбор между ними — не дело вкуса: каждая отвечает на свой вопрос быстро, а на чужой — медленно и криво.

Как выбрать за пять секунд

Массив

Упорядоченный список. Элементы идут по порядку, у каждого есть номер — индекс.

Товары = Новый Массив;
Товары.Добавить("Гвозди");
Товары.Добавить("Шурупы");

Товары[0];              // "Гвозди" — индексы с НУЛЯ
Товары.Количество();    // 2
Товары.ВГраница();      // 1 — номер последнего
Товары.Найти("Шурупы"); // 1, а если нет — Неопределено

Соответствие

Пары «ключ → значение». Позволяет мгновенно достать значение по ключу, не перебирая всё подряд.

Цены = Новый Соответствие;
Цены.Вставить("Гвозди", 150);
Цены.Вставить("Шурупы", 80);

Цены["Гвозди"];        // 150
Цены["Молоток"];       // Неопределено — ключа нет
Цены.Количество();     // 2

Цена = Цены[Товар];
Если Цена = Неопределено Тогда
	Цена = 0;
КонецЕсли;

Как обходят соответствие

В цикле Для Каждого по соответствию переменная получает не значение, а пару. У пары есть .Ключ и .Значение.

Обход пар

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

Структура

Набор именованных полей одного объекта. Имена полей известны заранее, когда пишется код.

Позиция = Новый Структура;
Позиция.Вставить("Товар", "Гвозди");
Позиция.Вставить("Количество", 10);

// или короче, одной строкой:
Позиция = Новый Структура("Товар, Количество", "Гвозди", 10);

Позиция.Товар;          // "Гвозди" — обращение через точку
Позиция.Количество;     // 10

Значение = 0;
Если Параметры.Свойство("Цена", Значение) Тогда
	// поле есть, и оно уже лежит в переменной Значение
КонецЕсли;

ТаблицаЗначений

Строки и колонки, как в таблице. Умеет сама сортировать, группировать и считать итоги.

Т = Новый ТаблицаЗначений;
Т.Колонки.Добавить("Товар");
Т.Колонки.Добавить("Сумма");

СтрокаФайла = Т.Добавить();          // добавили пустую строку
СтрокаФайла.Товар = "Гвозди";
СтрокаФайла.Сумма = 1500;

Т.Итог("Сумма");             // сумма по всей колонке
Т.Сортировать("Сумма Убыв");
Т.Свернуть("Товар", "Сумма");  // сгруппировать и сложить

Коллекции передаются по ссылке

Это свойство, из-за которого случаются самые загадочные ошибки.

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

С числом или строкой так не бывает: они копируются.

Процедура Испортить(Ч)
	Ч = 999;
КонецПроцедуры

Число = 5;
Испортить(Число);
// Число по-прежнему 5

Процедура Испортить(М)
	М.Добавить(999);
КонецПроцедуры

Массив = Новый Массив;
Испортить(Массив);
// в Массиве теперь есть 999

Ещё две коллекции, без которых не обойтись

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

СписокЗначений

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

Склады = Новый СписокЗначений;
Склады.Добавить("Основной", "Основной склад");
Склады.Добавить("Резерв", "Резерв цеха");

Склады[0].Значение;          // "Основной" — что внутри
Склады[0].Представление;     // "Основной склад" — что видит человек
Склады[0].Пометка = Истина;  // галочка

Склады.НайтиПоЗначению("Резерв");  // элемент или Неопределено
Склады.СортироватьПоПредставлению();

Массив структур: таблица, которой не нужна таблица

Самая частая коллекция в типовом коде — не таблица значений, а массив структур. Каждая структура — строка, поля структуры — колонки.

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

Строки документа в памяти

Строки = Новый Массив;
Строки.Добавить(Новый Структура("Товар, Количество, Цена", "Гвозди", 10, 150));
Строки.Добавить(Новый Структура("Товар, Количество, Цена", "Шурупы", 3, 80));

Для Каждого Строка Из Строки Цикл
	Сообщить(Строка.Товар + ": " + Строка.Количество * Строка.Цена);
КонецЦикла;

Менять коллекцию, пока по ней идёшь

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

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

Для Сч = 0 По Массив.ВГраница() Цикл
	Если Массив[Сч] = 0 Тогда
		Массив.Удалить(Сч);
	КонецЕсли;
КонецЦикла;

Сч = Массив.ВГраница();
Пока Сч >= 0 Цикл
	Если Массив[Сч] = 0 Тогда
		Массив.Удалить(Сч);
	КонецЕсли;
	Сч = Сч - 1;
КонецЦикла;

Группировка в памяти: соответствие массивов

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

Устройство: соответствие, где ключ — группа, а значение — массив попавшего в неё. Единственная тонкость в том, что массив для новой группы надо создать, а для уже встреченной — взять существующий.

Разложить по складам

ПоСкладу = Новый Соответствие;

Для Каждого Строка Из Строки Цикл
	Список = ПоСкладу[Строка.Склад];
	Если Список = Неопределено Тогда
		Список = Новый Массив;
		ПоСкладу.Вставить(Строка.Склад, Список);
	КонецЕсли;
	Список.Добавить(Строка.Товар);
КонецЦикла;

Массив как параметр запроса

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

Один запрос вместо двадцати

Запрос.Текст =
"ВЫБРАТЬ Ссылка, Цена ИЗ Справочник.Номенклатура
|ГДЕ Ссылка В (&СписокТоваров)";

Запрос.УстановитьПараметр("СписокТоваров", Товары);

Шпаргалка по коллекциям

Что дальше

Коллекции — последняя тема «чистого языка». Дальше начинается сама 1С: справочники и документы, чтение и запись данных, программная работа с формами.

Как закрепить

Читать про код и писать код — разные умения. В тренажёре к этой главе идут упражнения: вы пишете решение, оно запускается на настоящем интерпретаторе 1С и проверяется сразу, без установки платформы.

Открыть эту главу в тренажёре

← Циклы: повторить для каждого
→ Справочники и документы: чтение и запись