Как экранировать кавычки в 1С

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

Основной способ экранирования в 1С — удвоение кавычки: два символа "" внутри строкового литерала воспринимаются как одна кавычка в значении. Это единственный штатный механизм, обратной косой черты, как в C или JavaScript, во встроенном языке 1С нет.

Проблема экранирования чаще всего возникает при формировании текстов запросов, XML, JSON, HTML, печатных форм и сообщений пользователю, где кавычки — часть контента. Ниже разобраны все рабочие приёмы, их ограничения и типичные ошибки.

Как работает удвоение кавычек в строковых литералах

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

Пример: Строка = "ООО ""Ромашка"" заключило договор"; — в переменной окажется текст ООО "Ромашка" заключило договор. Внешние кавычки — границы литерала, внутренние удвоенные — данные.

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

Наименование = "ООО ""Ромашка""";
Сообщить("Строка """""" содержит одну кавычку");

Экранирование кавычек в тексте запроса

Текст запроса в 1С — обычная строка, поэтому правила те же. Если в условии запроса нужно строковое значение с кавычками, каждую кавычку удваивают. Однако правильнее передавать такие значения через параметры запроса, а не встраивать в текст.

Пример без параметра: ТекстЗапроса = "ВЫБРАТЬ * ГДЕ Наименование = ""ООО """"Ромашка"""""""; — читать такую строку тяжело, ошибиться в подсчёте кавычек легко. Тот же запрос с параметром надёжнее:

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

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

Многострочные строки и вертикальная черта

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

Правила экранирования кавычек внутри многострочных литералов не меняются: кавычки в данных по-прежнему удваиваются. Вертикальная черта влияет только на перенос строки, а не на обработку кавычек.

Текст = "ВЫБРАТЬ
|    Контрагенты.Наименование
|ГДЕ
|    Контрагенты.Комментарий ПОДОБНО ""%""""важно""""%""";

Альтернативные способы вставки кавычек

Когда строка содержит много кавычек (например, формируется XML, JSON или HTML), удвоение делает код нечитаемым. Есть несколько практических альтернатив.

Функция Символ(34)

Код 34 — это код двойной кавычки в Unicode. Конструкция Символ(34) возвращает символ кавычки, который можно конкатенировать со строкой, не удваивая ничего: Результат = Символ(34) + "Ромашка" + Символ(34);. Часто код сохраняют в переменную с коротким именем, например Кав = Символ(34);, и используют её по всему модулю.

Замена через СтрЗаменить

При формировании больших шаблонов удобно писать текст с уникальным символом-заменителем (например, одинарной кавычкой или тильдой), а в конце заменить его на настоящую кавычку: Результат = СтрЗаменить(Шаблон, "~", Символ(34));. Шаблон при этом остаётся читаемым.

Кавычки при выгрузке в XML, JSON и CSV

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

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

Как проверить результат и типичные ошибки

Проверить итоговое значение строки проще всего через Сообщить() или вычисление выражения в отладчике (Shift+F9 в конфигураторе). В окне «Вычислить выражение» строка показывается с её фактическим значением — там видно, сколько кавычек реально попало в данные.

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

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

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