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

В коде 1С знак & перед процедурой означает директиву компиляции (где выполнится метод), # — инструкцию препроцессора (#Если, #Область), ~ — метку для оператора Перейти, | — продолжение многострочной строки, а ?(...) — условное выражение, аналог тернарного оператора. Внутри текста запроса тот же & уже означает параметр: &Контрагент.

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

Арифметика, присваивание и сравнение в языке 1С

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

Один знак = на две роли

В 1С нет отдельного ==. Знак = в начале инструкции — присваивание: Сумма = 100;. Внутри Если, Пока или справа от другого = — сравнение: ЕстьДолг = Сумма = 0; записывает в ЕстьДолг результат проверки.

Составных операторов вроде += или ++ в языке нет. Пишут полностью: Счетчик = Счетчик + 1;.

Как складываются разные типы

Тип результата определяет левый операнд:

• 🔤 "5" + 3 даёт строку "53": число приводится к строке;
• 🔢 3 + "5" даёт число 8: строка приводится к числу, а если не получится — ошибка «Преобразование значения к типу Число не может быть выполнено»;
• 📅 ТекущаяДата() + 86400 — та же дата через сутки: к дате прибавляются секунды;
• ⏱ разность двух дат — число секунд. Из примера в таблице: 2 592 000 / 86 400 = 30 дней.

Деление на ноль вызывает исключение «Деление на 0», а не возвращает бесконечность. Перед делением проверяйте знаменатель.

Логические операции и условное выражение ?()

Логических операций три: И, ИЛИ, НЕ. Приоритет от высокого к низкому: НЕ, затем И, затем ИЛИ. Поэтому А ИЛИ Б И В читается как А ИЛИ (Б И В). Скобки снимают все сомнения и читаются быстрее.

Сокращённое вычисление

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

Если Документ <> Неопределено И Документ.Проведен Тогда
	// обращение к Документ.Проведен выполнится,
	// только если Документ заполнен
КонецЕсли;

Если поменять условия местами, при пустом Документ получите ошибку «Поле объекта не обнаружено».

Тернарный оператор ?()

Условное выражение записывается как функция с вопросительным знаком:

Статус = ?(Остаток > 0, "Есть долг", "Расчёты закрыты");

Первый аргумент — условие, второй — значение при Истина, третий — при Ложь. Конструкции можно вкладывать, но после второго уровня код становится нечитаемым: лучше обычный Если ... ИначеЕсли ... КонецЕсли.

💡 Слово Не в начале условия часто пишут с заглавной и строчными буквами: Если Не ЗначениеЗаполнено(Объект.Склад) Тогда. Регистр в ключевых словах роли не играет: НЕ, Не и не равнозначны.

Знаки &, ~, |, # и другие символы в коде 1С

Эти символы сбивают с толку чаще всего, потому что в других языках они значат совсем другое.

Директивы компиляции &

В модуле управляемой формы каждая процедура помечена, где ей выполняться:

• 🖥 &НаКлиенте — на компьютере пользователя, без прямого доступа к базе;
• 🗄 &НаСервере — на сервере, с данными формы;
• ⚡ &НаСервереБезКонтекста — на сервере без передачи формы: быстрее, но реквизиты формы недоступны;
• 🔁 &НаКлиентеНаСервереБезКонтекста — метод можно вызвать и там, и там.

Метод в модуле формы без директивы компилируется на сервере. Отсюда частая ошибка новичков: процедура «не видна» из клиентского обработчика, потому что директиву забыли.

Аннотации в расширениях

В расширении конфигурации & перед процедурой говорит, как она соотносится с типовой. &Перед("ПередЗаписью") выполнится до типового метода, &После — после, &Вместо — заменит его. &ИзменениеИКонтроль копирует тело типового метода и позволяет внутри пометить правки инструкциями #Вставка ... #КонецВставки и #Удаление ... #КонецУдаления. Если после обновления типовой код изменился, платформа сообщит об этом при проверке расширения.

Символ @

В синтаксисе встроенного языка у @ нет значения. Вы увидите его только внутри комментариев: так подавляют предупреждения средств проверки кода, например в 1C:EDT. На выполнение программы такие строки не влияют.

Инструкции препроцессора: #Если и #Область

Строки, начинающиеся с #, обрабатываются до компиляции. Они решают, какой код вообще попадёт в модуль, или просто размечают его.

#Если ... #КонецЕсли

Отсекают код по месту выполнения:

#Если Сервер Или ТолстыйКлиентОбычноеПриложение Или ВнешнееСоединение Тогда
// код модуля объекта, который не должен попасть на тонкий клиент
#Иначе
ВызватьИсключение "Недопустимый вызов объекта на клиенте.";
#КонецЕсли

Это начало модуля менеджера или объекта во многих типовых конфигурациях. Символы препроцессора, которые встречаются чаще всего:

• Сервер, НаСервере, Клиент, НаКлиенте;
• ТонкийКлиент, ВебКлиент;
• ТолстыйКлиентОбычноеПриложение, ТолстыйКлиентУправляемоеПриложение;
• ВнешнееСоединение;
• МобильноеПриложениеКлиент, МобильноеПриложениеСервер.

Между ними допустимы И, Или, Не, а ветки — #ИначеЕсли и #Иначе.

#Область ... #КонецОбласти

Области на выполнение не влияют вовсе. Это разметка для сворачивания блоков в Конфигураторе и для порядка в модуле. В типовых решениях на БСП встречаются стандартные имена: ПрограммныйИнтерфейс, СлужебныйПрограммныйИнтерфейс, ОбработчикиСобытий, СлужебныеПроцедурыИФункции. Имя области пишется одним словом, без пробелов.

Ключевые слова встроенного языка: Новый, Выполнить, Продолжить и другие

Ключевое слово — зарезервированное имя, которое нельзя использовать как переменную. Их несколько десятков, вот те, что вызывают вопросы.

Знач и передача по ссылке

По умолчанию параметр передаётся по ссылке: если процедура изменит Сумма, изменится и переменная у вызывающего кода. Знач создаёт копию. Для коллекций копируется только ссылка: строки в переданную таблицу значений добавятся и с Знач.

Неопределено и Null — не одно и то же

Неопределено — значение необъявленной или незаполненной переменной. Null приходит из запросов: например, при левом соединении, когда справа нет записи. Null + 5 вызовет ошибку, поэтому в запросах суммы оборачивают в ЕСТЬNULL(Поле, 0).

Выполнить и Вычислить

Выполнить(Строка) исполняет текст как код, Вычислить(Строка) возвращает значение выражения. Так типовые конфигурации иногда вызывают методы по имени, полученному из настроек.

Выполнять строку, пришедшую от пользователя или из внешнего файла, нельзя без безопасного режима — это прямая дорога к выполнению чужого кода. Перед вызовом включают УстановитьБезопасныйРежим(Истина).

Редкие конструкции, которые путают даже опытных

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

Метка и Перейти

Для Каждого Строка Из Товары Цикл
	Если Строка.Количество = 0 Тогда
		Перейти ~Пропуск;
	КонецЕсли;
	// обработка строки
	~Пропуск:
КонецЦикла;

~Пропуск: объявляет метку (с двоеточием), Перейти ~Пропуск; переходит к ней. В современном коде вместо этого пишут Продолжить. Метка внутри цикла — признак кода, перенесённого из 1С 7.7.

Многострочная строка через |

Текст = "Первая строка
|Вторая строка
|Третья строка";

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

Повторный выброс ошибки

ВызватьИсключение; без текста внутри блока Исключение пробрасывает ту же ошибку дальше, сохранив её описание. Это не опечатка, а способ записать лог и не «проглотить» сбой.

Асинхронные методы: Асинх и Ждать

С платформы 8.3.18 появились асинхронные функции:

&НаКлиенте
Асинх Процедура Удалить(Команда)
	Ответ = Ждать ВопросАсинх("Удалить строку?", РежимДиалогаВопрос.ДаНет);
	Если Ответ = КодВозвратаДиалога.Да Тогда
		// удаление
	КонецЕсли;
КонецПроцедуры

Ждать приостанавливает процедуру, пока пользователь не ответит, без блокирующего модального окна. В коде до 8.3.18 ту же задачу решают через Новый ОписаниеОповещения и отдельную процедуру-обработчик ответа.

ДобавитьОбработчик

ДобавитьОбработчик Объект.Событие, ИмяПроцедуры; подписывает процедуру на событие объекта во время выполнения. Встречается редко, в основном при работе с внешними COM-объектами. Отписка — УдалитьОбработчик.

Разбор фрагмента кода построчно

Возьмём типичный обработчик команды формы документа: он считает сумму продаж контрагенту и пишет её в комментарий.

&НаКлиенте
Процедура ПосчитатьПродажи(Команда)
	Если Не ЗначениеЗаполнено(Объект.Контрагент) Тогда
		Сообщить("Укажите контрагента");
		Возврат;
	КонецЕсли;
	ПосчитатьПродажиНаСервере();
КонецПроцедуры

&НаСервере
Процедура ПосчитатьПродажиНаСервере()
	Запрос = Новый Запрос;
	Запрос.Текст =
	"ВЫБРАТЬ
	|	ЕСТЬNULL(СУММА(Продажи.СуммаДокумента), 0) КАК Сумма
	|ИЗ
	|	Документ.РеализацияТоваровУслуг КАК Продажи
	|ГДЕ
	|	Продажи.Контрагент = &Контрагент
	|	И Продажи.Проведен";
	Запрос.УстановитьПараметр("Контрагент", Объект.Контрагент);
	Выборка = Запрос.Выполнить().Выбрать();
	Итого = ?(Выборка.Следующий(), Выборка.Сумма, 0);
	Объект.Комментарий = СтрШаблон("Продажи: %1 руб.", Формат(Итого, "ЧДЦ=2"));
КонецПроцедуры

Что здесь происходит:

1. &НаКлиенте — первая процедура выполняется у пользователя. Параметр Команда платформа передаёт сама.
2. Если Не ЗначениеЗаполнено(...) — проверка, что контрагент выбран. Возврат прерывает процедуру, если нет.
3. Вызов ПосчитатьПродажиНаСервере() — переход с клиента на сервер. Иначе к базе не обратиться.
4. &НаСервере — серверный метод. Данные формы, включая Объект, доступны.
5. Новый Запрос создаёт объект запроса.
6. Текст запроса — многострочная строка: каждая строка после первой начинается с |.
7. &Контрагент внутри текста — параметр. Его значение задаёт УстановитьПараметр с тем же именем, но уже без &.
8. ЕСТЬNULL(..., 0) — если продаж нет, сумма вернётся нулём, а не Null.
9. Запрос.Выполнить().Выбрать() — цепочка вызовов через точку: выполнить запрос и получить выборку.
10. ?(Выборка.Следующий(), Выборка.Сумма, 0) — тернарный оператор: если строка есть, берём сумму, иначе 0.
11. СтрШаблон подставляет значение на место %1, Формат(Итого, "ЧДЦ=2") оставляет 2 знака после запятой.

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

Ошибки при чтении и правке чужого кода

Ниже то, на чём спотыкаются, когда впервые разбирают код типовой конфигурации:

• ❌ Путают & в коде и в запросе. Перед процедурой это директива, внутри строки запроса — параметр. Удалите & из текста запроса, и платформа будет искать поле с таким именем.
• ❌ Считают #Область условием. Область ничего не включает и не выключает. Код внутри неё выполняется всегда.
• ❌ Ждут, что = в Если присвоит значение. Внутри условия это только сравнение, переменная не изменится.
• ❌ Удаляют |, переформатируя запрос. Без вертикальной черты строковый литерал оборвётся, и модуль не скомпилируется.
• ❌ Правят типовой модуль напрямую. При следующем обновлении правки придётся переносить вручную. Изменения безопаснее делать в расширении с аннотациями &Перед, &После или &ИзменениеИКонтроль.

Частые вопросы