- •Глава 2 . Встроенный язык
- •2.1. Программные модули Виды программных модулей
- •Разделы программного модуля
- •Разделы программного модуля
- •Контекст
- •2.2. Конструкции встроенного языка
- •Условия
- •Логические выражения
- •Обработка исключений
- •Безусловные переходы
- •2.3. Процедуры и функции
- •2.4. Инструкции препроцессора
- •2.5. Типы данных
- •Объявление переменных
- •Оператор Новый
- •Приведение типов
2.3. Процедуры и функции
Процедуры и функции являются блоками программы, которые можно вызвать по имени из другого места, например, из другой процедуры. Процедуры и функции могут иметь параметры, которые говорят о том, какие именно действия и с какими объектами она должна сделать. Функции отличаются от процедур только тем, что имеют возвращаемое значение.
Ниже показана процедура Печать, функция ЕстьПравоИспользования и процедура КнопкаПечатьНажатие, которая вызывается при нажатии на кнопку «Печать»:
Процедура Печать(ТабДок)
Макет = ПолучитьМакет("Основной");
ТабДок.Вывести(Макет.ПолучитьОбласть("Бланк")) ;
КонецПроцедуры
Функция ЕстьПравоИспользования(ИмяОтчета)
//возвращаемое значение функции
Возврат ПравоДоступа("Использование", Отчеты[ИмяОтчета]);
КонецФункции
Процедура КнопкаПечатьНажатие(Элемент)
Если НЕ ЕстьПравоИспользования(ИмяОтчета) Тогда
Возврат; //досрочный выход из процедуры
КонецЕсли
ТабДок = Новый ТабличныйДокумент;
Печать(ТабДок); //вызов процедуры Печать
ТабДок.Показать();
КонецПроцедуры
Параметры у процедуры/функции могут быть необязательными. Тогда их можно будет опускать при вызове. Для необязательных параметров должно быть указано значение по умолчанию, например:
//следующая процедура принимает табличный документ,
//а если ничего не передано,
//то она его создает и показывает на экране
Процедура Печать(ТабДок = Неопределено) Экспорт
Если ТабДок = Неопределено Тогда
ТабДок = Новый ТабличныйДокумент;
флПоказывать = Истина;
Иначе
флПоказывать = Ложь;
КонецЕсли;
Макет = ПолучитьМакет("Основной");
ТабДок.Вывести(Макет.ПолучитьОбласть("Бланк"));
Если флПоказывать Тогда
ТабДок.Показать();
КонецЕсли;
КонецПроцедуры
Замечание. В 1С:Предприятии 8 порядок следования процедур и функций в модуле не важен. Это означает, что процедура может располагаться ниже места ее вызова, т.е. предварительное объявление процедур и функции не требуется (в версии 7.7 для этого использовалось ключевое слово Далее).
Процедуры и функции рекомендуется предварять комментариями с описанием их назначения, параметров, основных принципов работы и возвращаемого значения для функций. В редакторе модулей есть возможность свернуть процедуры и функции модуля, а также перейти на одну из них, выбрав ее из списка. Описания в виде комментариев также можно сворачивать.
Параметры процедуры или функции по умолчанию передаются по ссылке. Это означает, что изменение формального параметра внутри процедуры или функции приведет к изменению фактического параметра в том месте, где она вызывается. Чтобы гарантированно передать параметр по значению, нужно перед именем параметра вставить ключевое слово Знач.
2.4. Инструкции препроцессора
В «1С:Предприятии 8» были введены несколько предопределенных инструкций для препроцессора, которые говорят о том, где должен исполняться тот или иной фрагмент программы.
К инструкциям препроцессора относятся:
Инструкция |
Описание |
#Если Клиент Тогда … #КонецЕсли |
Выполнение фрагмента модуля на клиентской машине. |
#Если Сервер Тогда … #КонецЕсли |
Выполнение фрагмента модуля на сервере 1С:Предприятия 8. |
#Если ВнешнееСоединение Тогда … #КонецЕсли |
Эта инструкция позволяет включить возможность использования процедур и функции в сессии СОМ-соединения. |
Место выполнения общего программного модуля также может регулироваться установкой его свойств. Подробнее об инструкциях препроцессора и свойствах общих модулей написано в документации.
