Другое · 6 мин
Одиночная кавычка в 1С: как указать в строке и запросе
Как поставить одинарную кавычку в 1С: разница между встроенным языком и языком запросов, экранирование, проверка результата и частые ошибки.
В 1С:Предприятие одинарная кавычка — это символ апострофа, который чаще всего вводится обычной клавишей. Главное различие зависит от места использования: встроенный язык и язык запросов относятся к кавычкам по-разному.
В модулях встроенного языка строковые литералы ограничиваются двойными кавычками. Поэтому одинарная кавычка внутри такой строки не требует экранирования и воспринимается как обычный символ текста.
В языке запросов строковые литералы ограничиваются одинарными кавычками. Если в тексте запроса нужно указать одинарную кавычку внутри строки, её необходимо удвоить, иначе запрос вызовет синтаксическую ошибку.
Где в 1С могут понадобиться одинарные кавычки
Одиночная кавычка встречается в фамилия с апострофом, названиях товаров, комментариях, текстовых полях документов и справочников. Также она может появиться при обмене данными, формировании печатных форм и заполнении значений параметров запросов.
Одинарная кавычка внутри — обычный символ
Апостроф внутри экранируется удвоением
Сравните исходное значение и выведенный текст
Перед правкой кода или текста запроса уточните, где именно будет использоваться строка: в модуле объекта, в отчете, в обработке или в тексте запроса к базе данных. От этого зависит способ записи и правила экранирования.
Одиночная кавычка в встроенном языке 1С
В встроенном языке строковый литерал пишется в двойных кавычках. Пример: Строка = "О'Коннор";. Здесь одинарная кавычка не ломает строку и выводится как есть.
Если нужно собрать строку динамически, используйте конкатенацию или функцию для получения символа по коду. Это полезно, когда источник данных уже содержит апострофы и их нежелательно дублировать вручную.
Одиночная кавычка в языке запросов
Язык запросов требует ограничивать строковые литералы одинарными кавычками: 'Иванов'. Чтобы внутри такого текста встретилась одинарная кавычка, напишите её дважды подряд: 'О''Коннор'. Первый символ воспринимается как экранирующий, второй — как часть строки.
Правило удвоения действует только внутри строковых литералов запроса. Вне кавычек, в именах полей или табличных частях, одинарные кавычки не используются таким образом.
Вывод через код символа и конкатенацию
Когда в строке много апострофов или источник данных неконтролируемый, удобнее подставлять одинарную кавычку через код символа, а не вставлять её в литерал. Это снижает риск случайного разрыва строки при ручном редактировании.
Как проверить результат
Одна одинарная кавычка на месте
Два символа или ошибка синтаксиса
Записи с апострофом найдены
Запрос не выполняется или возвращает пустое
Пример подхода: сформируйте фрагмент отдельно и склейте с основным текстом оператором конкатенации. Перед вводом в промышленную эксплуатацию проверьте, как отображается результат в форме списка, документе и печатной форме.
Проверка и отладка результата
После вставки строки с апострофом откройте объект, в котором используется значение, и просмотрите его в представлении пользователя. Обратите внимание на обрезку текста, лишние символы и ошибки компиляции модуля.
Если строка попадает в запрос, выполните запрос в консоли или отладчике и убедитесь, что записи с апострофами находятся корректно. При отсутствии результата проверьте, не превратился ли удвоенный апостроф в два отдельных символа.
Частые ошибки и ограничения
Размещение одинарной кавычки в двойных кавычках внутри запроса приведет к ошибке, потому что язык запросов ожидает свои ограничители. Обратная ситуация тоже возможна: удвоение апострофа в обычном модуле создаст лишний символ в выводимом тексте.
Сравнение вариантов
Подходит для модулей форм и отчетов, одинарная кавычка внутри двойных кавычек не требует экранирования
Требует одинарных кавычек вокруг литерала и удвоения внутреннего апострофа
Неправильная работа с кавычками при выгрузке или загрузке данных может испортить контрагенты, номенклатуру и документы. Правки в конфигурации делайте на копии базы, а затем проверяйте на ограниченном наборе данных.
Сравнение способов указания кавычки
Выбор способа зависит от того, где строка будет интерпретироваться. Встроенный язык проще: двойные кавычки вокруг текста, апостроф внутри не трогаем. Запрос требует соблюдения своих правил: одинарные кавычки вокруг текста и удвоение внутреннего апострофа.
Что важно запомнить
В встроенном языке 1С одинарная кавычка внутри строки в двойных кавычках пишется как есть, а в языке запроса её нужно удваивать внутри одинарных кавычек.
Нужно ли экранировать одинарную кавычку в обычном модуле 1С?
Нет, если строка записана в двойных кавычках. Одиночная кавычка внутри такой строки является обычным символом и не ломает литерал.
Как написать фамилию с апострофом в запросе 1С?
Ограничьте строку одинарными кавычками и удвойте внутренний апостроф: например, 'О''Коннор'. Без удвоения запрос может завершиться синтаксической ошибкой.
Можно ли использовать код символа вместо кавычки?
Да, для вставки одинарной кавычки можно использовать получение символа по коду и конкатенацию. Это удобно при большом количестве апострофов или при формировании строки из нескольких частей.
Что проверить после изменения текста с кавычкой?
Проверьте отображение в интерфейсе пользователя, компиляцию модуля и выполнение запроса, если строка используется в отборе. Убедитесь, что нет обрезки текста и лишних символов.
Безопасно ли править кавычки в рабочей базе?
Не рекомендуется вносить изменения напрямую в рабочую базу. Сделайте копию, проверьте результат на ограниченном наборе документов и только затем переносите правку в основную конфигурацию по установленному процессу.