Как передать строку с кавычками в 1С

Во встроенном языке 1С строковый литерал заключается в двойные кавычки, поэтому обычная кавычка внутри текста «ломает» строку и вызывает синтаксическую ошибку ещё на этапе проверки модуля. Это одна из самых частых проблем начинающих разработчиков: нужно вывести фразу вида ООО «Ромашка», а конфигуратор ругается на непарную кавычку.

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

Ниже разобраны рабочие приёмы с примерами кода, ограничения каждого подхода и типичные ошибки, из-за которых кавычки теряются или появляются лишние.

Основной способ: удвоение кавычек в литерале

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

Наименование = "ООО ""Ромашка""";
Сообщить("Пользователь сказал: ""Привет!""");

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

Текст = "Слово в кавычках: ""тест""";

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

Многострочные строки и символ переноса

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

ТекстПисьма = "Уважаемый клиент!
|Ваша заявка ""Поставка-17"" принята в работу.
|Срок исполнения уточняйте у менеджера.";

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

Формирование строк через СтрШаблон и подстановку

Когда кавычки содержатся в переменной и их нужно вставить в готовый текст, удобнее СтрШаблон. Функция подставляет параметры вместо %1, %2 и так далее, а кавычки внутри подставляемых значений не требуют никакой обработки — они приходят «как есть».

Текст = СтрШаблон("Документ ""%1"" от %2 проведён", НомерДокумента, Формат(ДатаДокумента, "ДЛФ=D"));

Обратите внимание: кавычки вокруг %1 в шаблоне — это часть литерала, поэтому они удвоены. А вот значение переменной НомерДокумента подставляется без изменений, даже если само содержит кавычки.

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

Кавычки в динамических данных: СтрЗаменить и Символ(34)

Если строка приходит извне — из файла, формы, веб-сервиса — и нужно добавить или убрать кавычки программно, используют СтрЗаменить либо символ с кодом 34 (двойная кавычка в Unicode).

Кавычка = Символ(34);
Результат = Кавычка + ИсходнаяСтрока + Кавычка;
БезКавычек = СтрЗаменить(ИсходнаяСтрока, Кавычка, "");

Символ(34) полезен и тогда, когда код с удвоенными кавычками становится нечитаемым — например, при сборке сложных строк с множеством кавычек. Вместо визуальной «каши» из четырёх-пяти кавычек подряд получается понятная конструкция.

Кавычка = Символ(34);
Текст = "ООО " + Кавычка + "Ромашка" + Кавычка;
Сообщить(Текст); // ООО "Ромашка"

Кавычки в тексте запроса и параметрах

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

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Ссылка ИЗ Справочник.Контрагенты ГДЕ Наименование = &Наименование";
Запрос.УстановитьПараметр("Наименование", "ООО ""Ромашка""");

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

Кавычки при обмене данными: JSON и XML

При выгрузке в JSON не нужно экранировать кавычки вручную — это делает сериализатор. Используйте ЗаписатьJSON или ЗаписьJSON, и платформа сама превратит кавычки в управляющую последовательность \".

Запись = Новый ЗаписьJSON;
Запись.УстановитьСтроку();
ЗаписатьJSON(Запись, Новый Структура("Контрагент", "ООО ""Ромашка"""));
Результат = Запись.Закрыть();

Ручная сборка JSON конкатенацией строк — частый источник битых файлов: одна необработанная кавычка в наименовании делает весь документ невалидным. То же относится к XML: атрибуты с кавычками формируйте через ЗаписьXML, а не склейкой строк.

Проверка результата и отладка

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

Для JSON и XML дополнительная проверка — открыть результат в любом валидаторе или попробовать прочитать его обратно через ЧтениеJSON. Если чтение проходит без исключения, экранирование корректно.

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