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

Работа со строками в 1С:Предприятие 8.3 часто требует добавления кавычек — будь то для формирования SQL-запросов, динамического создания кода или обработки пользовательского ввода. Однако неопытные разработчики сталкиваются с ошибками компиляции, когда платформа воспринимает кавычку внутри строки как её окончание. Эта проблема особенно актуальна при работе с запросами 1С, где кавычки используются для обозначения строковых литералов, или при генерации кода через Выполнить().

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

Почему кавычки в строках 1С вызывают ошибки

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

Сообщить("Текст с "кавычкой" внутри");  // Ошибка: неожиданный конец строки

Аналогичная ситуация возникает в запросах 1С, где кавычки используются для обозначения строковых параметров:

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

Здесь платформа "обрежет" строку на первом знаке " после =, что приведёт к ошибке выполнения. Решение этой проблемы зависит от контекста использования строки.

Способ 1: Удвоение кавычек (классический метод)

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

Сообщить("Текст с ""кавычкой"" внутри");  // Выведет: Текст с "кавычкой" внутри

Этот метод работает и в текстах запросов:

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

⚠️ Внимание: Удвоение кавычек не работает в динамически выполняемом коде через Выполнить(), если строка формируется с использованием других методов экранирования. В таких случаях требуется комбинировать подходы.

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

• 🔹 Поддерживается во всех версиях 1С:Предприятие (включая 7.7)
• 🔹 Не требует дополнительных функций или библиотек
• 🔹 Чётко видно в коде, где начинаются и заканчиваются строковые литералы

Способ 2: Использование функции СтрЗаменить()

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

ТекстСКавычками = СтрЗаменить(ИсходныйТекст, """", """""");
Сообщить(ТекстСКавычками);

Пример для запроса:

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

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

Способ 3: Символы Юникода для кавычек

В 1С:Предприятие 8.3 поддерживаются символы Юникода, что позволяет использовать альтернативные виды кавычек, не требующие экранирования:

• 🔹 « » — французские ("ёлочки")
• 🔹 „ “ — немецкие ("лапки")
• 🔹 ‘ ’ — одинарные угловые

Пример использования:

Сообщить("Текст с «кавычками» внутри");  // Не требует экранирования

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

• 🔹 Не требует экранирования
• 🔹 Визуально отличается от стандартных кавычек (полезно для документов)
• 🔹 Поддерживается в отчётах и печатных формах

Ограничения:

• 🔸 Не подходит для SQL-запросов (только стандартные кавычки)
• 🔸 Может вызвать проблемы при экспорте данных в системы, не поддерживающие Юникод

Способ 4: Экранирование для динамического выполнения кода

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

Решение — тройное экранирование:

КодДляВыполнения = "Сообщить(""Текст с """"кавычками"""" внутри"");";
Выполнить(КодДляВыполнения);

Разберём по шагам:

1. Внешние кавычки (") ограничивают строку для Выполнить()
2. Первое удвоение ("") экранирует кавычки для строки внутри Сообщить()
3. Второе удвоение ("""") экранирует кавычки для вложенной строки

Для упрощения можно использовать функцию СтрШаблон():

Шаблон = "Сообщить(""Текст с %1 внутри"")";
Результат = СтрШаблон(Шаблон, """"""""Кавычками"""""""");
Выполнить(Результат);

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

Способ 5: Использование параметров запросов вместо строк

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

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

Преимущества подхода:

• 🔹 Автоматическое экранирование специальных символов
• 🔹 Защита от инъекций
• 🔹 Улучшенная читаемость кода
• 🔹 Поддержка сложных типов данных (даты, булевы значения)

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

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

Даже опытные разработчики 1С иногда допускают ошибки при работе с кавычками. Вот наиболее распространённые случаи:

1. Непарные кавычки: забывают удвоить обе кавычки в паре.

   // Ошибка:
   Сообщить("Текст с "кавычкой"");  // Первая кавычка не экранирована

2. Пробелы между удвоенными кавычками:

   // Ошибка:
   Сообщить("Текст с "" кавычкой """);  // Пробелы разрывают экранирование

3. Использование одинарных кавычек:

   // Ошибка в 1С (одинарные кавычки не поддерживаются):
   Сообщить('Текст с 'кавычкой'');

4. Экранирование в динамическом коде:

   // Ошибка:
   Код = "Сообщить("Текст с ""кавычками"")";  // Требуется тройное экранирование

Для отладки сложных строк с кавычками используйте приём "поэтапного построения":

Часть1 = "ВЫБРАТЬ Наименование ИЗ Справочник.Номенклатура ГДЕ ";
Часть2 = "Наименование = """;
Часть3 = СтрЗаменить(ПараметрПоиска, """", """""");
Часть4 = """";
Запрос.Текст = Часть1 + Часть2 + Часть3 + Часть4;

⚠️ Внимание: При работе с внешними источниками данных (например, HTTP-сервисами или файлами JSON/XML) учитывайте, что правила экранирования кавычек могут отличаться. Например, в JSON используются обратные слеши (\), которые в 1С требуют дополнительной обработки.

FAQ: Частые вопросы по работе с кавычками в 1С

ТекстДляДокумента = "Пример текста с «кавычками» для отчёта";
Документ.ДобавитьТекст(ТекстДляДокумента);

ТекстДляДокумента = СтрЗаменить(ИсходныйТекст, """", """""");
Документ.ДобавитьТекст(ТекстДляДокумента);

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

Запрос.УстановитьПараметр("Параметр", "ООО ""Ромашка""");

ТекстДляAPI = СтрЗаменить(ИсходныйТекст, """", "\""");
Запрос = Новый HTTPЗапрос("https://api.example.com/data");
Запрос.Заголовки.Вставить("Content-Type", "application/json");
Запрос.УстановитьТекст("{\"name\": \"" + ТекстДляAPI + "\"}");

ТекстДляURL = СтрЗаменить(ИсходныйТекст, """", "%22");

// Ошибка:
Сообщить('Это не сработает');

ВЫРАЗИТЬ("Если Наименование = """"Пример"""" Тогда 1 Иначе 0 КонецЕсли"" как Булево)

ТекстФормулы = "ВЫРАЗИТЬ(""Если Наименование = """""" + Параметр + """""" Тогда 1 Иначе 0 КонецЕсли"" как Булево)";
ТекстФормулы = СтрЗаменить(ТекстФормулы, """", """""");
Поле.Выражение = ТекстФормулы;