Обращение к колонке массива в 1С: полное руководство с примерами кода

Работа с массивами в 1С:Предприятие — одна из самых частых задач при разработке конфигураций и написании обработок. Но когда речь заходит о доступе к конкретной колонке (столбцу) двумерного массива или таблицы значений, даже опытные программисты иногда путаются в синтаксисе. Почему? Потому что в 1С нет классического понятия"столбец" как в Excel или SQL — здесь всё строится на индексах и коллекциях.

Эта статья разберёт 5 основных способов обращения к колонкам массивов в 1С 8.3 и 1С 8.2, включая нюансы работы с таблицами значений, массивами массивов и динамическими списками. Мы также рассмотрим типичные ошибки (например, Индекс вне границ массива) и оптимизацию кода для ускорения обработки больших данных.

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

1. Основы: что такое"колонка" в массиве 1С?

В классическом программировании двумерный массив представляется как таблица с строками и столбцами. В 1С это реализовано иначе:

• 📌 Массив массивов — каждый элемент первого уровня сам является массивом (аналог строки). Колонка здесь — это элемент вложенного массива с одинаковым индексом во всех"строках".
• 📊 Таблица значений — объект с явными колонками (Колонки), строками (Строки) и методами доступа (Получить, Установить).
• 🔄 Динамический список — более сложная структура, где колонки определяются запросом или программно.

Важно понимать, что в 1С индексация начинается с 0, но в таблицах значений часто используется 1-индексация (например, при обращении по имени колонки). Это приводит к путанице. Например, код:

Массив = Новый Массив;
Массив.Добавить(Новый Массив); // Строка 0
Массив[0].Добавить("Ячейка 0,0"); // Колонка 0
Массив[0].Добавить("Ячейка 0,1"); // Колонка 1

здесь Колонка 1 — это второй элемент вложенного массива.

Критическое отличие от Excel: в 1С нет буквенных обозначений колонок (A, B, C). Вместо этого используются числовые индексы или имена (для таблиц значений).

2. Способ 1: Обращение по индексу в массиве массивов

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

// Создаём двумерный массив 3x2
Данные = Новый Массив;
Данные.Добавить(Новый Массив(10, 20)); // Строка 0: [10, 20]
Данные.Добавить(Новый Массив(30, 40)); // Строка 1: [30, 40]
Данные.Добавить(Новый Массив(50, 60)); // Строка 2: [50, 60]

// Получаем значение из колонки 1 (второй элемент) строки 0
Значение = Данные[0][1]; // Вернёт 20

Ошибки, которые здесь часто допускают:

• ❌ Перепутан порядок индексов: Данные[1][0] вместо Данные[0][1].
• ❌ Выход за границы: если в строке только 2 элемента, обращение к [2] вызовет исключение.
• ❌ Непроверенный массив: если Данные[0] не является массивом, будет ошибка.

⚠️ Внимание: При работе с большими массивами (1000+ строк) такой метод может быть медленнее, чем использование таблиц значений, из-за накладных расходов на динамическое выделение памяти.

3. Способ 2: Работа с колонками в таблице значений

Таблицы значений (ТаблицаЗначений) — самый удобный инструмент для работы с табличными данными в 1С. Здесь колонки имеют имена и типы, что упрощает доступ. Пример:

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

// Добавляем строку
Строка = ТЗ.Добавить;
Строка.Наименование ="Товар 1";
Строка.Цена = 100;

// Получаем значение из колонки"Цена" первой строки
Цена = ТЗ[0].Цена; // 100

Преимущества этого метода:

• 🔹 Читаемость кода: обращение по имени колонки (Строка.Цена) вместо индексов.
• 🔹 Типизация: 1С контролирует типы данных при добавлении.
• 🔹 Методы доступа: можно использовать Получить и Установить.

Недостатки:

• ⚠️ Медленнее массивов при большом количестве строк (10 000+).
• ⚠️ Требует явного объявления колонок.

Цены = ТЗ.ВыгрузитьКолонку("Цена"); // Массив всех цен

4. Способ 3: Использование метода Получить

Универсальный метод Получить работает и для массивов, и для таблиц значений. Синтаксис:

Значение = Объект.Получить(ИндексСтроки, ИндексКолонки); // Для массива
Значение = ТаблицаЗначений.Получить(ИндексСтроки, ИмяКолонки); // Для ТЗ

Примеры:

// Для массива массивов
Значение = Данные.Получить(0, 1); // Эквивалент Данные[0][1]

// Для таблицы значений
Значение = ТЗ.Получить(0,"Цена"); // Эквивалент ТЗ[0].Цена

Когда это удобно:

• 🎯 Динамическое формирование имени колонки (например, в цикле).
• 🎯 Обработка ошибок: метод возвращает Неопределено, если индекс вне границ (в отличие от исключения при прямом обращении).

⚠️ Внимание: В таблицах значений метод Получить работает медленнее прямого доступа (ТЗ[0].Цена). Используйте его только когда необходимо динамическое имя колонки.

4. Способ 4: Работа с динамическими списками

Динамические списки (ДинамическийСписок) используются для отображения данных в формах и отчётах. Здесь колонки определяются запросом или программно. Пример доступа:

ДС = Новый ДинамическийСписок;
ДС.ИсточникДанных = Новый ОписаниеИсточникаДанных(ТЗ); // ТЗ - таблица значений

// Получаем значение первой строки, колонки"Цена"
Значение = ДС.ПолучитьЭлемент(0).Цена;

Особенности:

• 🔄 Колонки могут добавляться динамически (например, в зависимости от прав пользователя).
• 🔄 Поддерживает сортировку и фильтрацию"на лету".
• ⚠️ Медленнее таблиц значений из-за дополнительного слоя абстракции.

Колонка существует в источнике данных|Индекс строки не превышает количество элементов|Тип данных колонки совместим с операцией|Динамический список привязан к форме (если нужно)-->

5. Производительность: какой метод быстрее?

Мы протестировали скорость разных методов на массиве 10 000 × 10 (100 000 ячеек). Результаты (время в мс):

1. Массивы массивов + прямое обращение по индексу.

2. Таблицы значений + ВыгрузитьКолонку для пакетной обработки.-->

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

6. Типичные ошибки и как их избежать

Ошибка №1: Индекс вне границ массива

• 🛑 Причина: Обращение к несуществующему индексу (например, Данные[0][5] в массиве с 2 колонками).
• 🔧 Решение: Проверяйте длину массива:

  Если Данные[0].Количество > 5 Тогда
  Значение = Данные[0][5];
  КонецЕсли;

Ошибка №2: Поле объекта не обнаружено (Цена)

• 🛑 Причина: Опечатка в имени колонки таблицы значений или колонка не добавлена.
• 🔧 Решение: Проверяйте существование колонки:

  Если ТЗ.Колонки.Найти("Цена") <> Неопределено Тогда
  Цена = ТЗ[0].Цена;
  КонецЕсли;

Ошибка №3: Тип не совместим с ожидаемым

• 🛑 Причина: Попытка записать строку в колонку типа Число.
• 🔧 Решение: Преобразуйте тип явно:

  ТЗ[0].Цена = Число("100.50");

⚠️ Внимание: В версиях 1С 8.3.20+ при обращении к несуществующей колонке таблицы значений вместо ошибки может возвращаться Неопределено. Это изменение поведения может маскировать ошибки в коде!

FAQ: Частые вопросы по работе с колонками

ТЗ.Колонки.Добавить("НоваяКолонка", Новый ОписаниеТипов("Строка"));

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

ВсеЦены = ТЗ.ВыгрузитьКолонку("Цена"); // Массив значений

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

Сообщить(Данные[0].Количество); // Сколько колонок в первой строке?
Сообщить(ТЗ.Колонки.Количество); // Сколько колонок в ТЗ?

ТЗ.Сортировать("Цена Убыв"); // По убыванию
ТЗ.Сортировать("Наименование Возр"); // По возрастанию

ТЗ.Сортировать("Наименование Возр, Цена Убыв");