1С СтрСоединить: чем заменить функцию и как объединять строки

Функция СтрСоединить появилась в платформе 1С:Предприятие 8.3.6 и объединяет массив строк в одну строку через указанный разделитель. Если конфигурация работает на более старой версии платформы, при попытке использовать функцию возникает ошибка «Процедура или функция с указанным именем не определена». В этом случае нужна замена — либо цикл с конкатенацией, либо собственная универсальная функция.

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

Как работает СтрСоединить: синтаксис и параметры

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

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

Результат = СтрСоединить(Товары, ", ");
// Результат: "Гвозди, Молоток, Пила"

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

Элементы массива должны быть строками либо значениями, которые платформа способна неявно привести к строке. Числа и даты обычно преобразуются автоматически, но формат такого преобразования зависит от региональных настроек, поэтому надёжнее приводить значения явно через Строка() или Формат().

Чем заменить СтрСоединить на старых платформах

Если конфигурация должна работать на платформе ниже 8.3.6, используйте классический цикл с накоплением строки. Это самый совместимый способ — он работает на любой версии платформы, включая 8.2.

Функция СоединитьСтроки(МассивСтрок, Разделитель = "") Экспорт

Результат = "";
Для Индекс = 0 По МассивСтрок.ВГраница() Цикл
Если Индекс > 0 Тогда
Результат = Результат + Разделитель;
КонецЕсли;
Результат = Результат + МассивСтрок[Индекс];
КонецЦикла;

Возврат Результат;

КонецФункции

Проверка Индекс > 0 нужна, чтобы разделитель не появился перед первым элементом. Альтернативный приём — добавлять разделитель после каждого элемента, а в конце обрезать лишний через Лев(), но первый вариант читается проще и не требует вычисления длины разделителя.

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

Функция СоединитьСтроки(МассивСтрок, Разделитель = "") Экспорт
	Результат = "";
	Для Индекс = 0 По МассивСтрок.ВГраница() Цикл
		Если Индекс > 0 Тогда
			Результат = Результат + Разделитель;
		КонецЕсли;
		Результат = Результат + МассивСтрок[Индекс];
	КонецЦикла;
	Возврат Результат;
КонецФункции

Замена через СтрШаблон и другие встроенные средства

Когда нужно соединить не массив, а фиксированный набор значений, удобнее СтрШаблон. Функция подставляет параметры в шаблон на месте маркеров %1, %2 и так далее. Она доступна на платформах старше 8.3.6 тоже, поэтому часто выступает заменой ручной конкатенации.

СтрокаАдреса = СтрШаблон("%1, %2, д. %3", Город, Улица, НомерДома);

Для объединения строк с переносом строки вместо СтрСоединить иногда проще сложить строки через Символ.ПС в цикле или собрать текст через объект ТекстовыйДокумент с последующим ПолучитьТекст(). Текстовый документ автоматически расставляет переводы строк между добавленными строками.

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

Производительность: почему цикл может «тормозить»

Строки в 1С неизменяемы: каждая операция Результат = Результат + Часть создаёт новую строку в памяти и копирует старое содержимое. На массиве из десятков элементов это незаметно, но при объединении тысяч строк в цикле время работы растёт квадратично.

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

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

Типичные ошибки при объединении строк

Самая частая ошибка — передача в СтрСоединить не массива, а другой коллекции. Платформа выдаёт ошибку несоответствия типов. Решение: преобразуйте коллекцию, например ТаблицаТоваров.ВыгрузитьКолонку("Наименование") вернёт именно массив.

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

Третья ошибка — неявное преобразование NULL из запроса. Значение NULL нельзя привести к строке напрямую, обращение вызовет ошибку. Используйте ЕСТЬNULL(Поле, "") в запросе либо проверку ЗначениеЗаполнено() при обходе выборки.

Как проверить результат и выбрать подход

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

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

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