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

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

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

В отличие от некоторых других языков программирования, 1С обладает строгой типизацией в контексте операций сложения. Это означает, что вы не можете просто «склеить» число и строку без явного преобразования типов. Игнорирование этого правила приведет к ошибке выполнения, которая остановит работу сеанса пользователя. Поэтому важно всегда следить за тем, что именно находится в вашей переменной перед операцией конкатенации.

Использование оператора сложения для строк

Самый интуитивно понятный и распространенный способ объединить две строки — использовать оператор +. В языке 1С этот оператор перегружен для работы с типом Строка. Когда вы пишете код, система автоматически создает новую строку, которая является суммой операндов.

Рассмотрим пример, где нам нужно сформировать приветственное сообщение. Мы берем имя пользователя из переменной и добавляем к нему фиксированный текст. Синтаксис предельно прост, но требует внимания к пробелам, так как компилятор не добавляет их автоматически между склеиваемыми частями.

ИмяПользователя = "Алексей";
Приветствие = "Добрый день, " + ИмяПользователя + "!";
Сообщить(Приветствие);

Если переменная имеет тип, отличный от строки, например Число или Дата, попытка использовать оператор + вызовет ошибку. В таких случаях необходимо предварительно привести данные к строковому виду с помощью функции Строка(). Это правило касается всех примитивных типов данных, кроме Булево, которое иногда ведет себя специфично в разных версиях платформы.

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

💡

Если вам нужно собрать очень длинный текст из множества мелких частей, используйте объект TextDocument или буфер, чтобы избежать излишней нагрузки на сборщик мусора.

Функция СокрЛ и работа с пробелами

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

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

🧹 СокрЛ() удаляет пробелы только в начале строки.
🧹 СокрП() удаляет пробелы только в конце строки.
🧹 Сокр() удаляет пробелы с обоих концов.

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

КодТовара = " 12345 ";
Артикул = "ART-" + Сокр(КодТовара);
// Результат: "ART-12345"

Стоит отметить, что функции сокращения работают только с символами пробела (код 32). Другие управляющие символы, такие как табуляция или перенос строки, требуют использования более сложных методов обработки, например, функции СтрЗаменить(). Это важно учитывать при импорте данных из внешних источников, где форматирование может быть нарушено.

Методы объекта Строка в современных версиях

Начиная с определенных версий платформы 1С:Предприятие 8, тип данных Строка получил собственные методы для работы с содержимым. Это позволяет писать код в объектно-ориентированном стиле, что повышает его читаемость. Однако, поскольку строка неизменяема, методы возвращают новую строку, а не модифицируют существующую.

Для добавления текста можно использовать цепочки вызовов, хотя прямого метода Append (как в C# или Java) у строки нет. Тем не менее, методы СтрНачинаетсяС или СтрЗаканчиваетсяС часто используются перед добавлением, чтобы избежать дублирования текста. Логика проверки и добавления становится более явной.

Метод	Описание	Возвращаемое значение
`Врег()`	Преобразует строку к верхнему регистру	Новая строка
`Нрег()`	Преобразует строку к нижнему регистру	Новая строка
`СтрЗаменить()`	Заменяет подстроку на другую	Новая строка
`Лев()`	Получает левую часть строки	Подстрока

Использование методов особенно удобно при форматировании вывода. Например, перед добавлением текста «руб.» к сумме, вы можете привести число к строке и отформатировать его. Комбинирование глобальных функций и методов объекта дает гибкость в решении задач любой сложности.

⚠️ Внимание: Методы типа Строка появились в относительно новых версиях платформы. Если ваша конфигурация должна работать на старых релизах (например, 8.2 или ранние 8.3), используйте только глобальные функции.

Совместимость методов

Методы объекта Строка стали доступны массово с платформы 8.3.10. До этого момента разработчики были ограничены набором глобальных функций языка.

Конкатенация в запросах и СКД

Отдельного внимания заслуживает добавление текста к переменным внутри запросов к базе данных. В языке запросов 1С оператор + также используется для конкатенации, но синтаксис имеет свои нюансы. Здесь важно различать переменные языка 1С и параметры запроса.

При формировании текста запроса в коде разработчика, вы часто подставляете значения в строку запроса. Делать это через простую конкатенацию строк опасно из-за риска SQL-инъекций (хотя в 1С это менее критично, чем в вебе, но все же возможно). Правильный подход — использование параметров.

ТекстЗапроса = "ВЫБРАТЬ
|  Справочник.Номенклатура.Наименование КАК Наименование
|ИЗ
|  Справочник.Номенклатура
|ГДЕ
|  Справочник.Номенклатура.Наименование ПОДОБНО &Фильтр";

Фильтр = "%" + ПоискТекста + "%";
Результат = Запрос.Выполнить();

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

💡

Всегда используйте параметры в запросах вместо прямой подстановки переменных в текст запроса через конкатенацию. Это обеспечивает безопасность и правильное использование индексов.

Форматирование строк через Формат()

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

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

💰 Для денежных сумм используйте формат ЧЦ=10; ЧДЦ=2; ДФ=0.00 "руб.".
📅 Для дат можно добавить текст: ДФ="ДД.ММ.ГГГГ 'года'".
🔢 Для чисел с разделителями: ЧГ=0; ЧР=0; ЧВН="-"; ДФ="### ##0".

Пример использования показывает, как компактно можно решить задачу форматирования. Вместо трех строк кода с присваиванием и сложением, вы получаете результат в одну строку. Это снижает вероятность ошибки и упрощает поддержку кода в будущем.

Сумма = 1500.50;
ТекстСуммы = Формат(Сумма, "ЧЦ=15; ЧДЦ=2; ДФ=0.00 \"руб.\"");
// Результат: "   1500.50 руб."

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

☑️ Правила использования Формат()

Указать тип значенияЗадать строку форматаЭкранировать кавычкиПроверить результат

Выполнено: 0 / 4

Особенности работы с NULL и Неопределено

Одной из самых коварных ошибок при добавлении текста является попытка конкатенации со значением Неопределено (NULL). В 1С, если переменная имеет значение Неопределено, операция сложения со строкой не приведет к автоматическому преобразованию в пустую строку, как это бывает в некоторых языках. Вместо этого вы получите ошибку или непредсказуемое поведение в зависимости от контекста.

Перед тем как добавить текст к переменной, всегда проверяйте ее на заполненность. Для этого используется функция ЗначениеЗаполнено() или явное сравнение с Неопределено. Это правило «гигиены кода» спасет вас от многих ошибок в промышленной эксплуатации.

⚠️ Внимание: В запросах значение NULL обрабатывается иначе, чем в коде 1С. Пустая строка и NULL в базе данных — это разные сущности. Учитывайте это при фильтрации.

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

Если ЗначениеЗаполнено(Комментарий) Тогда
ПолноеОписание = "Инфо: " + Комментарий;
Иначе
ПолноеОписание = "Инфо отсутствует";
КонецЕсли;

Такой подход делает логику программы прозрачной. Пользователь всегда видит понятное сообщение, а система не падает с ошибкой «Операция сложения не определена для типов..». Обработка граничных значений — признак квалификации разработчика 1С.

Почему Неопределено опасно

Тип Неопределено не имеет методов и свойств. Попытка обратиться к ним или использовать в арифметике вызывает исключение.

Часто задаваемые вопросы (FAQ)

Можно ли добавить текст к переменной типа Число без преобразования?

Нет, напрямую нельзя. Оператор + для числа и строки вызовет ошибку. Необходимо использовать функцию Строка(Число) для явного преобразования типа перед конкатенацией.

Как добавить перенос строки к тексту в 1С?

Для добавления переноса строки используйте символ Символы.ПС (Перевод Строки) или Символы.ВК (Возврат Каретки). Пример: Текст = "Строка 1" + Символы.ПС + "Строка 2".

В чем разница между Сокр() и СтрЗаменить(Текст, " ", "")?

Функция Сокр() удаляет пробелы только по краям строки (слева и справа). Функция СтрЗаменить() с таким параметром удалит ВСЕ пробелы внутри строки, включая те, что между словами.

Как быстро добавить текст в конец массива строк?

Массив строк нельзя конкатенировать оператором +. Нужно использовать метод Массив.Добавить("НовыйТекст"). Если нужно объединить все элементы массива в одну строку, используйте функцию СтрСоединить(Массив, Разделитель).

Почему код работает в толстом клиенте, но выдает ошибку в веб-клиенте?

Веб-клиент имеет ограничения на выполнение некоторых операций и доступ к файловой системе. Убедитесь, что вы не используете специфические объекты или методы, недоступные в режиме управляемого приложения или веб-браузера.

Методы добавления текста к переменной в коде 1С