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

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

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

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

Синтаксис строковых литералов в коде 1С

Основным правилом языка является использование двойных кавычек для обрамления строковых констант. Если вы пишете код Сообщить("Привет"), то система понимает, что внутри скобок находится текст. Но что делать, если сам текст должен содержать кавычку? Для этого в синтаксисе 1С предусмотрен механизм удвоения разделителя.

Чтобы отобразить двойную кавычку внутри строки, заключенной в двойные кавычки, необходимо написать её дважды подряд. Компилятор интерпретирует последовательность "" как один печатный символ, а не как конец строки. Это стандартная практика во многих языках программирования, обеспечивающая однозначность parsing кода.

Рассмотрим пример, где необходимо вывести фразу, содержащую цитату. Без экранирования код вызовет ошибку, так как компилятор посчитает строку законченной после первого слова.

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

Если вы попытаетесь использовать одинарные кавычки таким же образом внутри двойных, они будут восприняты как обычные символы текста без всякого экранирования, так как для системы это разные символы.

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

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

Это значительно упрощает работу с текстами на иностранных языках или специфическими названиями. Вам не нужно применять никаких специальных приемов, чтобы написать слово O'Connor или фразу "машина 'Жигули'". Просто впишите их внутрь строки.

• 🔹 Одинарная кавычка внутри двойных: пишется как есть '
• 🔹 Двойная кавычка внутри двойных: требует удвоения ""
• 🔹 Комбинирование: можно свободно смешивать оба типа в одной строке

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

Экранирование кавычек в запросах 1С

Написание запросов в 1С представляет собой отдельную сложность, так как текст запроса сам по себе является строковым литералом в коде 1С, но внутри него используется свой собственный синтаксис с одинарными кавычками для значений. Здесь возникает эффект "матрешки", когда нужно экранировать символы на двух уровнях.

В языке запросов 1С строковые значения в условиях (например, в операторе ГДЕ) должны быть заключены в одинарные кавычки. Но поскольку весь текст запроса в коде 1С уже находится в двойных кавычках, нам нужно правильно вписать туда одинарные.

Уровень вложенности	Символ ограничителя	Способ экранирования
Код 1С (внешний)	Двойная кавычка (")	Удвоение ("")
Текст запроса (внутренний)	Одинарная кавычка (')	Удвоение ('')
Результат в БД	Одинарная кавычка (')	Одинарный символ

Чтобы передать в запрос значение, содержащее одинарную кавычку (например, фамилию Д'Артаньян), внутри текста запроса её нужно удвоить. Но так как текст запроса записан в строке 1С, нам нужно убедиться, что эти одинарные кавычки не конфликтуют с внешними двойными (что не происходит) и правильно интерпретируются движком запросов.

ТекстЗапроса = "ВЫБРАТЬ
|  Справочник.Контрагенты.Наименование
|ИЗ
|  Справочник.Контрагенты
|ГДЕ
|  Справочник.Контрагенты.Наименование = 'ООО ""Вектор''";

Обратите внимание на нюанс: в примере выше внутри строки запроса используется одинарная кавычка для ограничения значения. Если бы нам нужно было написать внутри значения запроса саму одинарную кавычку, мы бы написали её дважды: ''. А если бы внутри значения нужна была двойная кавычка, мы бы написали "" внутри строки 1С, что для запроса выглядело бы как одна двойная кавычка.

Почему в запросах используются одинарные кавычки?

Исторически сложилось, что язык запросов 1С (подобно SQL) использует одинарные кавычки для строковых литералов, чтобы отличать их от идентификаторов и ключевых слов, которые часто не требуют кавычек или используют другие символы.

Динамическое формирование строк и конкатенация

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

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

Внимание ⚠️ При формировании текста запроса через конкатенацию переменных с пользовательским вводом возникает риск SQL-инъекций. Никогда не подставляйте данные от пользователя напрямую в текст запроса через сложение строк. Используйте параметризированные запросы.

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

• ✅ Используйте параметры запроса (&Параметр) для данных пользователя
• ✅ Экранируйте только статические части строки в коде
• ❌ Избегайте ручного добавления кавычек вокруг значений переменных в тексте запроса

Такой подход не только решает проблему с кавычками, но и повышает производительность системы за счет кеширования планов выполнения запросов. Ручная сборка строк с кавычками часто приводит к тому, что каждый уникальный текст воспринимается как новый запрос.

Работа с символами через кодировку и функции

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

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

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

Шаблон = "Выберите элемент из списка: %1";
// Допустим, мы хотим обернуть подсказку в кавычки
Результат = СтрЗаменить(Шаблон, "%1", """Справочник.Номенклатура""");

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

Типичные ошибки и методы отладки

Самая распространенная ошибка при работе с кавычками — это несбалансированность. Разработчик открывает строку двойной кавычкой, но забывает экранировать внутреннюю кавычку, из-за чего компилятор считает строку законченной prematurely. Ошибка обычно указывает на строку, следующую за проблемной, что может сбить с толку.

Внимание ⚠️ Ошибка синтаксиса часто проявляется не там, где пропущена кавычка, а в следующей строке кода, которую компилятор пытается интерпретировать как продолжение строки или команду. Всегда проверяйте парность кавычек в предыдущей строке.

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

Еще одна частая проблема — путаница между "умными" (типографскими) кавычками и программными. При копировании кода из Word или веб-сайтов обычные прямые кавычки " могут замениться на «елочки» «» или парные "". Компилятор 1С не распознает типографские кавычки как разделители строк, что вызовет ошибку.

⚠️ Внимание: Интерфейс и подсветка синтаксиса могут отличаться в разных версиях конфигуратора (8.2, 8.3, 8.3.20+). Всегда сверяйтесь с актуальной документацией по вашей версии платформы, так как правила лексического анализа могут незначительно меняться.

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

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

Можно ли использовать одинарные кавычки для объявления строки в 1С?

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

Как написать три двойные кавычки подряд в строке?

Для этого нужно написать шесть двойных кавычек подряд: """""". Каждая пара "" интерпретируется как один символ кавычки. Таким образом, три пары дадут три символа в результирующей строке.

Почему в запросе кавычки ведут себя иначе, чем в обычном коде?

Текст запроса — это строка для 1С, но язык запросов внутри этой строки имеет свой синтаксис. Внутри запроса строковые значения ограничиваются одинарными кавычками. Поэтому возникает двойное экранирование: одинарные для запроса, двойные для кода 1С (если нужно вставить двойную кавычку в значение запроса).

Что делать, если нужно вставить переменную в строку с кавычками?

Используйте конкатенацию. Например: "Текст """ + Переменная + """ продолжение". Переменная вставляется как есть, а кавычки вокруг неё (если нужны) прописываются как литералы с экранированием в частях строки до и после переменной.

Влияет ли раскладка клавиатуры на вид кавычек в коде?

Да, критически. В коде допустимы только стандартные ASCII кавычки (код 34). Кавычки из русской раскладки или типографские символы не будут распознаны компилятором как разделители строк и вызовут ошибку.