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

Другое · 6 мин

Ключевое слово Знач в параметрах 1С: суть и практическое применение

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

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

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

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

Когда использовать Знач для простых типов

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

Пример объявления может выглядеть так: Процедура РассчитатьСкидку(Знач Сумма, Знач Процент). Внутри процедуры переменные Сумма и Процент можно присваивать заново, не опасаясь, что значения у вызывающего кода изменятся после завершения процедуры.

Что происходит со сложными типами и объектами

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

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

Как проверить поведение параметра

Надёжный способ — запустить процедуру в отладчике с точкой остановки в начале и после присваивания параметру. Сравните значение исходной переменной до вызова, внутри процедуры и после возврата управления вызывающему коду. Так можно увидеть, защитил ли Знач переменную от присваивания.

Для ссылочных типов проверяйте не только саму переменную, но и содержимое объекта: строки таблицы, свойства структуры или реквизиты документа. Если они изменились после вызова, причина может быть в общей ссылке, а не в отсутствии слова Знач.

Как проверить параметр в отладчике
  1. 1
    Поставьте точку остановки на начале процедуры
  2. 2
    Сравните значения параметра и исходной переменной до присваивания
  3. 3
    Выполните присваивание параметру и проверьте исходную переменную после выхода

Частые ошибки и риски

Одна из типичных ошибок — считать, что Знач полностью изолирует таблицу значений или объект от изменений. Изменение ячейки таблицы или свойства объекта через такой параметр всё равно может затрагивать исходные данные, потому что копируется ссылка, а не весь объект.

Другая ошибка — помечать все параметры подряд словом Знач без необходимости. Это делает код менее гибким и может скрыть намерение передать данные для изменения. Также не стоит полагаться на Знач как на способ защиты от порчи данных: для этого нужны явные копии или отдельные рабочие объекты.

Типичные ошибки
01
Думать, что Знач полностью копирует таблицу значений или объект — ссылка может остаться общей
02
Помечать все параметры Знач без необходимости, что усложняет чтение кода
03
Изменять содержимое переданного объекта и ожидать, что вызывающий код не заметит изменений

Альтернативы и способы защиты данных

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

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

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

Как отличить ожидаемое поведение от ошибки

Исходная переменная после присваивания параметру
Норма

Значение осталось прежним

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

Значение изменилось, хотя параметр был помечен как Знач

Содержимое переданного объекта
Норма

Изменения свойств могут быть общими для обеих сторон

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

Полная замена объекта внутри процедуры отразилась на вызывающей стороне

Быстрый выбор способа передачи

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

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

Итог

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

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

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

Нет. Знач ставится только там, где важно защитить переменную вызывающего кода от присваивания внутри процедуры. Если процедура должна изменить переданное значение или вернуть его через параметр, слово не ставится.

Защищает ли Знач таблицу значений от изменений строк?

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

Можно ли использовать Знач с объектами справочников и документами?

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

Как убедиться, что параметр не изменил исходные данные?

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