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

Другое · 6 мин

Как передать массив в функцию в 1С:Предприятии

Как передать массив в функцию 1С: объявление параметра, вызов, влияние на исходный массив, защита от нежелательных изменений и проверка типа перед работой.

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

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

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

Как объявить функцию с параметром массива

В заголовке функции достаточно указать имя параметра, например Массив. Тело функции может обходить массив циклом «Для каждого», обращаться к элементам по индексу, проверять количество элементов и выполнять вычисления. Явное описание типа параметра зависит от версии платформы и контекста, поэтому в типовом коде параметр часто оставляют без строгого типа, а проверку делают внутри тела.

Пример объявления функции, которая суммирует числовые элементы массива:

Функция СуммаЭлементов(Массив) Экспорт
Сумма = 0;
Для Каждое Элемент Из Массив Цикл
Сумма = Сумма + Элемент;
КонецЦикла;
Возврат Сумма;
КонецФункции

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

Как вызвать функцию и передать массив

Порядок передачи массива
  1. 1
    Создайте или получите массив перед вызовом
  2. 2
    Убедитесь, что переменная содержит массив, а не неопределённое значение
  3. 3
    Передайте переменную в функцию при вызове
  4. 4
    Присвойте результат или проверьте побочные эффекты

Вызов выполняется по имени функции со списком параметров в скобках. Переменная с массивом передаётся без дополнительных символов, например Результат = СуммаЭлементов(МоиЧисла);. Если массив пустой, функция должна корректно обработать это состояние и вернуть ожидаемое значение, обычно ноль или пустой результат, в зависимости от логики задачи.

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

Что происходит с исходным массивом после вызова

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

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

Как защитить исходный массив от изменений

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

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

Проверка типа и пустоты перед работой

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

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

Тип переданного значения
Норма

Значение является массивом

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

Значение не является массивом или не определено

Количество элементов
Норма

Массив содержит ожидаемые элементы или пуст по логике

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

Массив пуст, хотя ожидались данные

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

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

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

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

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

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

Итог

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

Массив передаётся в функцию по имени параметра; изменения элементов обычно влияют на исходный массив, замена параметра — нет; проверяйте тип и используйте копию при необходимости защиты данных.

Часто задаваемые вопросы

Можно ли передать массив в процедуру, а не только в функцию?

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

Нужно ли указывать тип массива в заголовке функции?

Явное указание типа зависит от версии платформы и контекста. В типовом коде параметр часто объявляется без типа, а проверка того, что передан именно массив, выполняется внутри тела функции.

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

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

Что делать, если функция изменяет массив, а это не нужно?

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