К статье
Практический материал

Другое · 6 мин

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

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

В 1С:Предприятие одинарная кавычка — это символ апострофа, который чаще всего вводится обычной клавишей. Главное различие зависит от места использования: встроенный язык и язык запросов относятся к кавычкам по-разному.

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

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

Где в 1С могут понадобиться одинарные кавычки

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

Встроенный языкСтрока в двойных кавычках

Одинарная кавычка внутри — обычный символ

Язык запросовСтрока в одинарных кавычках

Апостроф внутри экранируется удвоением

РезультатОтображение в форме или отчете

Сравните исходное значение и выведенный текст

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

Одиночная кавычка в встроенном языке 1С

В встроенном языке строковый литерал пишется в двойных кавычках. Пример: Строка = "О'Коннор";. Здесь одинарная кавычка не ломает строку и выводится как есть.

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

Одиночная кавычка в языке запросов

Язык запросов требует ограничивать строковые литералы одинарными кавычками: 'Иванов'. Чтобы внутри такого текста встретилась одинарная кавычка, напишите её дважды подряд: 'О''Коннор'. Первый символ воспринимается как экранирующий, второй — как часть строки.

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

Вывод через код символа и конкатенацию

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

Контрольные точки

Как проверить результат

Отображение текста в форме
Норма

Одна одинарная кавычка на месте

Тревожный признак

Два символа или ошибка синтаксиса

Выполнение запроса
Норма

Записи с апострофом найдены

Тревожный признак

Запрос не выполняется или возвращает пустое

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

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

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

Типичные ошибки
01
Поставить одинарную кавычку в строковом литерале запроса без удвоения
02
Дублировать апостроф в обычной строке встроенного языка
03
Редактировать конфигурацию напрямую в рабочей базе без копии

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

Частые ошибки и ограничения

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

Сравнение вариантов

Встроенный язык

Подходит для модулей форм и отчетов, одинарная кавычка внутри двойных кавычек не требует экранирования

Язык запросов

Требует одинарных кавычек вокруг литерала и удвоения внутреннего апострофа

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

Сравнение способов указания кавычки

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

Итог

Что важно запомнить

В встроенном языке 1С одинарная кавычка внутри строки в двойных кавычках пишется как есть, а в языке запроса её нужно удваивать внутри одинарных кавычек.

Нужно ли экранировать одинарную кавычку в обычном модуле 1С?

Нет, если строка записана в двойных кавычках. Одиночная кавычка внутри такой строки является обычным символом и не ломает литерал.

Как написать фамилию с апострофом в запросе 1С?

Ограничьте строку одинарными кавычками и удвойте внутренний апостроф: например, 'О''Коннор'. Без удвоения запрос может завершиться синтаксической ошибкой.

Можно ли использовать код символа вместо кавычки?

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

Что проверить после изменения текста с кавычкой?

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

Безопасно ли править кавычки в рабочей базе?

Не рекомендуется вносить изменения напрямую в рабочую базу. Сделайте копию, проверьте результат на ограниченном наборе документов и только затем переносите правку в основную конфигурацию по установленному процессу.