Ключевое слово ФУНКЦИЯ
Ключевое слово ФУНКЦИЯ указывает на начало описания библиотечной функции или метода.
ФУНКЦИЯ [БЫСТР] [<воз_значение>:] <имя_функции>[
[ПЕРЕМ] <тип_параметра_1>: параметр_1.1 [, параметр_1.2 [ ... ]]
[; [ПЕРЕМ] <тип_параметра_2>: параметр_2.1 [, параметр_2.2 [ ... ]]]
[; ...]
]
Параметры
- воз_значение
- Тип возвращаемого значения. Допускается использование одного из простых (не объектных) типов. Если тип возвращаемого значения опущен, функция может не возвращать никакого значения, либо возвращать значение любого из простых типов. В последнем случае контроль соответствия типов отдается на усмотрение пользователя.
- имя_функции
- Имя (идентифкатор) создаваемой функции. Функцию следует называть согласно соглашению об именованиях.
- тип_параметра_N
- Тип входных параметров функции.
- параметр_N
- Входные параметры функции. При указании ключевого слова ПЕРЕМ перед типом параметра в функцию передается параметр-переменная. В этом случае при выходе из функции исходное значение переменной изменяется в соответствии с действиями внутри функции. Параметры одного типа перечисляются через запятую, группы параметров разного типа разделяются точкой с запятой. Количество групп и параметров в группе не ограничено. Отдельные параметры группы параметров могут располагаться в описании в любом порядке. Может быть несколько групп с одинаковым типом.
Замечания:
- Заголовок функции должен находится на одной строке. Объясняется это тем, что при загрузке данных о функциях библиотеки механизм чтения предельно прост, что обеспечивает скорое выполнение этого процесса. То же касается слова слова КОНЕЦ_ФУНКЦИИ.
- Заголовки функций загружаются в одну таблицу в рамках расчета одного бланка. Поэтому, в библиотеках, используемых этим бланком, не должно быть функций с одинаковыми именами. Описание параметров функции следует за ее названием и заключается в круглые скобки. Функции можно не передавать ни одного параметра, тогда описание может быть опущено. Под описанием параметра подразумевается указание его типа и способа передачи в функцию.
Примеры заголовков функций:
ФУНКЦИЯ ЗначНалог
ФУНКЦИЯ ТИП_ДАТА: Вчера
ФУНКЦИЯ ТИП_СТРОКА: ИзмСтроку(ТИП_СТРОКА: строка)
ФУНКЦИЯ ТИП_ЛОГИКА: ПлощадьТреугольника(ТИП_ЧИСЛО: сторона_1,
сторона_2, сторона_3; ПЕРЕМ ТИП_ЧИСЛО: площадь)