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

Другое · 10 мин

Что возвращает функция в 1С: виды возвращаемых значений и проверка результата

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

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

Тип возвращаемого значения зависит от того, для чего создана функция: встроенная системная или пользовательская. Встроенные функции работают со строками, числами, датами, справочниками, документами, регистрами и другими объектами конфигурации. Пользовательская функция возвращает то, что разработчик указал в блоке Возврат.

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

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

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

Булевы функции возвращают Истину или Ложь и часто применяются в условиях If и операторах выбора. Функции, работающие с объектами конфигурации, могут возвращать ссылки на справочники, документы, перечисления или планы видов характеристик. Такие ссылки не являются самими объектами, а только указывают на них в базе данных.

Какие типы значений может вернуть функция

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

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

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

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

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

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

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

Результат функцииЧисло, строка, дата, булево, ссылка, Неопределено

Определите ожидаемый тип перед вызовом

Пустая ссылкаОбъект не найден

Проверяйте наличие ссылки перед доступом к реквизитам

НеопределеноРезультат не сформирован

Используйте проверку на Неопределено и пустоту

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

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

Частые ошибки при работе с возвращаемым значением

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

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

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

Порядок действий
  1. 1
    Определите ожидаемый тип возвращаемого значения
  2. 2
    Вызовите функцию и сохраните результат в переменную
  3. 3
    Проверьте результат на Неопределено и пустую ссылку
  4. 4
    Используйте значение только после успешной проверки

Встроенные и пользовательские функции

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

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

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

Когда функция не возвращает ожидаемый результат

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

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

Типичные ошибки
01
Использование результата функции без проверки на Неопределено
02
Обращение к реквизитам пустой ссылки, возвращённой функцией поиска
03
Путаница между функцией и процедурой при попытке присвоить результат

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

Безопасная самостоятельная работа с функциями

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

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

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

Тип значения, возвращённого функцией
Норма

Соответствует объявленному или ожидаемому типу

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

Неопределено, пустая ссылка или несоответствие типа

Наличие объекта по ссылке
Норма

Ссылка ведёт на существующий элемент

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

Пустая ссылка или ссылка на удалённый объект

Заполненность таблицы значений или набора записей
Норма

Есть хотя бы одна строка по условиям отбора

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

Пустой результат при ожидаемых данных

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

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

Итог

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

Функция в 1С всегда возвращает значение, и результат нужно проверять на Неопределено, пустые ссылки и соответствие ожидаемому типу перед использованием в расчётах и документах.

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

Что делать, если функция возвращает Неопределено?

Проверьте входные параметры и условия отбора: возможно, объект не найден, реквизит не заполнен или данные отсутствуют за выбранный период. Используйте явную проверку на Неопределено перед дальнейшей обработкой результата.

Может ли функция вернуть несколько значений сразу?

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

В чём разница между функцией и процедурой?

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

Как проверить, что ссылка, возвращённая функцией, не пустая?

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

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

Явное указание типа рекомендуется, так как оно помогает платформе контролировать корректность возврата и упрощает отладку. Если тип не указан, функция может вернуть значение любого типа, что увеличивает риск ошибок при использовании.

Может ли ошибка в функции повредить данные?

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