Почему функция в 1С меняет значение переданной переменной и как это предотвратить

← На главную

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

Почему изменяется значение исходной переменной

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

Рассмотрим пример кода, в котором возникает нежелательный побочный эффект:


// Вызывающий код
Перем1 = 10;
ТЗ = ФормированиеСчетов.ВернутьСчет(Перем1);
// Здесь Перем1 уже содержит измененное значение!

// Функция в общем модуле
Функция ВернутьСчет(НомерID) Экспорт
    НомерID = ЧислоЛистов - НомерID;
    // Дальнейший алгоритм формирования счета
    Возврат РезультатТаблица;
КонецФункции

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

Решение 1: Использование ключевого слова Знач

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

Посмотрим на исправленный заголовок функции:


Функция ВернутьСчет(Знач НомерID) Экспорт
    НомерID = ЧислоЛистов - НомерID;
    // Исходная переменная вызывающего кода не изменится
    Возврат РезультатТаблица;
КонецФункции

Особенности работы со сложными и мутабельными типами данных

Проанализируем важный нюанс: модификатор Знач гарантирует защиту от изменения только для примитивных типов данных (Число, Строка, Дата, Булево). Если в качестве параметра передается мутабельный объект (например, Структура, Соответствие, Массив или ТаблицаЗначений), ключевое слово Знач копирует только указатель на этот объект в памяти.

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


Функция ОбработатьДанные(Знач ИсходнаяТаблица) Экспорт
    // Создаем независимую копию объекта
    ЛокальнаяТаблица = ИсходнаяТаблица.Скопировать();
    ЛокальнаяТаблица.Очистить();
    
    Возврат ЛокальнаяТаблица;
КонецФункции

Решение 2: Использование локальных переменных в теле метода

Если сигнатуру метода изменить нельзя (например, функция находится в типовой неизменяемой конфигурации или используется внешними интеграциями), исключим переприсваивание входного аргумента внутри алгоритма. Для этого создадим отдельную локальную переменную внутри метода:


Функция ВернутьСчет(НомерID) Экспорт
    // Не перезаписываем параметр НомерID, а объявляем локальную переменную
    ВычисленныйНомерID = ЧислоЛистов - НомерID;
    
    // Все последующие действия выполняем с ВычисленныйНомерID
    Возврат РезультатТаблица;
КонецФункции

Решение 3: Возврат составного результата через структуру

Если алгоритм функции действительно должен возвращать не только основной результат, но и вычисленные сопутствующие данные, правильнее не модифицировать параметры, а возвращать объект типа Структура:


Функция ВернутьСчет(Знач НомерID) Экспорт
    ОстатокЛистов = ЧислоЛистов - НомерID;
    
    Результат = Новый Структура;
    Результат.Вставить("ТаблицаСчетов", РезультатТаблица);
    Результат.Вставить("ОстатокЛистов", ОстатокЛистов);
    
    Возврат Результат;
КонецФункции

Поведение при клиент-серверных вызовах и кэшировании

Разберем две важные архитектурные особенности платформы 1С:

Клиент-серверное взаимодействие: При вызове серверного метода с клиента (директивы &НаСервере или &НаСервереБезКонтекста) параметры всегда передаются по значению из-за сериализации данных при передаче по сети. Изменение примитивного параметра на сервере не отразится на клиенте, даже если модификатор Знач не был указан. Передача по ссылке действует только внутри единого контекста исполнения (клиент–клиент или сервер–сервер).
Модули с повторным использованием значений: Если функция расположена в общем модуле с признаком повторного использования возвращаемых значений, платформа кэширует результат по значениям входных параметров. Если такая функция возвращает мутабельный объект (например, Структура или Массив), и вызывающий код изменяет полученный результат, объект испортится прямо в кэше платформы. Все последующие вызовы этой функции с теми же параметрами вернут поврежденные данные.

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