Ковалев Сергей. Программирование на алгоритмическом языке MQL4
Подождите немного. Документ загружается.
111
находится вверху, в то время как в отношении описаний функций допускается
произвольный порядок.
Рис. 32. Обычный порядок расположения функциональных блоков в программе
(рекомендуется).
Рис. 33. Возможные варианты расположения функциональных блоков в программе
(произвольный порядок).
Особо нужно отметить:
Ни одна функция не может быть описана внутри другой функции.
Использование в программе описания функции, расположенного внутри
другой функции, запрещено.
Ниже представлены примеры неправильно расположенного описания функции.
112
Рис. 34. Примеры неправильного расположения описаний функций в программе.
Если программист ошибочно составит программу, в которой описание какой-либо
функции расположено в пределах описания другой функции, на этапе компиляции
редактор MetaEditor выдаст сообщение об ошибке, и исполняемый файл для такой
программы создан не будет.
6.1.4 Последовательность исполнения кода в программе
6.1.4.1 Головная часть и специальные функции
С момента, когда программа запущена на исполнение в окне финансового инструмента,
исполняются строки головной части программы.
После того как приготовления, описанные в головной части, выполнены, клиентский
терминал передаёт управление специальной функции init(), в результате чего эта функция
исполняется (передача управления показана на структурной схеме крупными жёлтыми
стрелками). Специальная функция init() вызывается для исполнения один раз в начале
работы программы. В этой функции обычно указывается код, который необходимо
выполнить один раз перед началом основной работы программы. Например, при
исполнении функции init() выполняется инициализация некоторых глобальных
переменных, в окне финансового инструмента отображаются графические объекты,
выводятся те или иные сообщения. Когда все программные строки в функции init()
исполнены, функция заканчивает исполнение, в результате чего управление возвращается
клиентскому терминалу.
113
Основное время работы программы - это период работы функции start(). При некоторых
условиях (см. свойства специальных функций в разделе Специальные функции), в том
числе - при поступлении в клиентский терминал нового тика с сервера, клиентский
терминал вызовет для исполнения специальную функцию start(). Эта функция (как и
другие функции) может обращаться к информационному окружению клиентского
терминала, производить необходимые вычисления, открывать и закрывать ордера, словом
производить любые действия, позволенные правилами языка MQL4. Обычно в ходе
исполнения специальной функции start() вырабатывается решение, которое реализуется в
виде управляющего воздействия (красная стрелка). Таким управляющим воздействием
может быть сформированный программой торговый приказ на открытие, закрытие или
модификацию ордера.
После того как весь код специальной функции start() эксперта будет исполнен, функция
start() закончит свою работу и вернёт управление клиентскому терминалу. Некоторое
время клиентский терминал будет удерживать управление, не запуская на исполнение ни
одну из специальных функций. Возникает пауза, в течение которой программа не
работает. В дальнейшем, при поступлении нового тика, клиентский терминал снова
передаст управление специальной функции start(), в результате чего она снова начнёт
исполняться, а по окончании исполнения вернёт управление клиентскому терминалу. На
следующем тике функция start() снова будет запущена на исполнение клиентским
терминалом.
Процесс многократного вызова на исполнение специальной функции start() клиентским
терминалом будет продолжаться до тех пор, пока программа прикреплена к окну
финансового инструмента, и может продолжаться недели и месяцы. В течение всего этого
периода эксперт может осуществлять автоматическую торговлю, т.е. выполнять своё
основное назначение. На схеме процесс многократного исполнения функции start()
показан несколькими крупными жёлтыми стрелками, огибающими специальную функцию
start().
В момент, когда трейдер отсоединит эксперт от окна финансового инструмента,
клиентский терминал один раз запустит на исполнение специальную функцию deinit().
Исполнение этой функции вызвано необходимостью корректного завершения работы
эксперта. В процессе работы программа может, например, создавать графические объекты
и глобальные переменные клиентского терминала. Поэтому в коде функции deinit()
обычно указываются программные строки, исполнение которых приводит к удалению
114
теперь уже ненужных объектов и переменных. После завершения исполнения
специальной функции deinit() управление возвращается клиентскому терминалу.
Исполняющиеся специальные функции могут обращаться к информационному
окружению (тонкие синие стрелки на схеме) и вызывать для исполнения пользовательские
функции (тонкие жёлтые стрелки). Обратите внимание на то, что специальные функции
выполняются в результате их вызова клиентским терминалом в порядке,
предопределённом в свойствах этих функций: сначала init(), потом (многократно) start() и
потом deinit(). Условия, при которых клиентский терминал вызывает специальные
функции, описаны в разделе Специальные функции.
6.1.4.2 Пользовательские функции
Пользовательские функции исполняются тогда, когда в какой-нибудь функции встретился
вызов этой пользовательской функции. В этом случае управление передаётся на время в
пользовательскую функцию, а по её завершении возвращается в место вызова (тонкие
оранжевые стрелки на схеме). Вызов на исполнение пользовательской функции может
содержаться не только в описании специальной функции, но и в описании вызываемых из
неё других пользовательских функций. Одни пользовательские функции могут вызывать
для исполнения другие пользовательские функции - такой порядок вызова
пользовательских функций является позволительным и широко используется в практике
программирования.
Пользовательские функции не вызываются для исполнения клиентским терминалом.
Любые пользовательские функции всегда выполняются в рамках исполнения какой-то из
специальных функций, возвращающих управление клиентскому терминалу.
Пользовательские функции также могут запрашивать (использовать) для обработки
значения переменных окружения - информационной среды клиентского терминала
(тонкие синие стрелки на схеме).
Если в программе имеется описание пользовательской функции, но нигде не встречается
вызов её на исполнение, то такая пользовательская функция будет исключена из готовой
программы на этапе компиляции и в процессе работы программы использоваться не
будет.
115
Обратите внимание: специальные функции вызываются для исполнения
клиентским терминалом. Пользовательские функции исполняются в
результате их вызова из специальных или других пользовательских
функций, но никогда не вызываются клиентским терминалом.
Управляющее воздействие (торговые приказы) может быть
сформировано как в специальных, так и в пользовательских функциях.
6.2 Специальные функции
Отличительной особенностью программ, предназначенных для работы в клиентском
терминале MetaTrader 4, является их работа с постоянно обновляющейся информацией в
режиме реального времени. В языке MQL4 эта особенность нашла своё отражение в виде
трёх специальных функций: init(), start() и deinit().
Специальные функции - это функции с предопределёнными именами init(), start() и
deinit(), обладающие специальными собственными свойствами.
6.2.1 Свойства специальных функций
6.2.2 Общее свойство специальных функций
Главным свойством всех специальных функций является их исполнение в программе при
определённых условиях без использования вызова специальной функции из программы.
Специальные функции вызываются для исполнения клиентским терминалом. Если в
программе есть описание специальной функции, то она будет вызвана (и исполнена) в
соответствии с условиями вызова (собственными свойствами).
Специальные функции вызываются для исполнения клиентским
терминалом.
116
6.2.3 Собственные свойства специальных функций
6.2.3.1 Специальная функция init().
Собственным свойством специальной функции init() является её исполнение при запуске
(инициализации) программы. Если в программе есть описание специальной функции
init(), то она будет вызвана (и исполнена) в момент запуска программы. Если в программе
нет специальной функции init(), то при запуске программы не выполняется никаких
действий.
В экспертах специальная функция init() вызывается (и исполняется) также сразу после
старта клиентского терминала и подгрузки исторических данных, после смены
финансового инструмента и/или периода графика, после перекомпиляции программы в
редакторе MetaEditor, после смены входных параметров из окна настройки эксперта и
после смены счёта.
В скриптах специальная функция init() вызывается (и исполняется) сразу после
прикрепления к графику финансового инструмента.
В пользовательских индикаторах специальная функция init() вызывается (и исполняется)
сразу после старта клиентского терминала, после смены финансового инструмента и/или
периода графика, после перекомпиляции программы в редакторе MetaEditor и после
смены входных параметров из окна настройки пользовательского индикатора.
6.2.3.2 Специальная функция start().
Собственные свойства специальной функции start() отличаются в зависимости от вида
исполняемой программы.
В экспертах специальная функция start() вызывается (и исполняется) сразу после прихода
очередного тика. Если новый тик поступил в период выполнения специальной функции
start(), то этот тик будет проигнорирован, т.е. вызов на исполнение специальной функции
start() в момент прихода такого тика осуществляться не будет. Все котировки, пришедшие
117
в период выполнения специальной функции start(), будут проигнорированы. Запуск
специальной функции start() на исполнение производится клиентским терминалом только
при условии, что предыдущий сеанс работы полностью завершён, управление передано
клиентскому терминалу и специальная функция start() находится в ожидании нового тика.
На возможность вызова и исполнения специальной функции start() влияет состояние
кнопки "Разрешить/запретить советников". Если указанная кнопка находится в состоянии
запрета, то клиентский терминал не будет вызывать для исполнения специальную
функцию start() вне зависимости от поступления новых котировок. Вместе с тем, перевод
этой кнопки из разрешающего состояния в состояние запрета не прерывает текущий сеанс
работы специальной функции start().
Специальная функция start() не вызывается клиентским терминалом на выполнение при
открытом окне свойств эксперта. Окно свойств эксперта может быть открыто для
внесения изменений только в период, когда специальная функция start() находится в
состоянии ожидания нового тика. Это окно не может быть открыто в момент текущего
сеанса выполнения специальной функции start() эксперта.
В скриптах специальная функция start() вызывается (и исполняется) один раз сразу после
выполнения инициализации программы в специальной функции init().
В пользовательских индикаторах специальная функция start() вызывается (и исполняется)
сразу после прихода очередного тика, сразу после прикрепления индикатора к графику,
при изменении размеров окна финансового инструмента, при переходе пользователем от
одного окна финансового инструмента к другому, при открытии клиентского терминала
(если в предыдущем сеансе работы индикатор был прикреплен к графику) а также после
смены символа или периода текущего графика вне зависимости от поступления новых
котировок.
Прекращение текущего сеанса выполнения специальной функции start() для программ
всех видов может осуществляться по причине отсоединения программы от графика,
смены финансового инструмента и/или периода графика, смены счета, закрытия графика,
а также в результате завершения работы клиентского терминала. Если специальная
функция start() выполнялась в момент команды на завершение работы, то время,
отпущенное терминалом для завершения исполнения функции, составляет 2,5 секунды.
Если после поступления команды на завершение работы специальная функция start()
118
продолжит работу более указанного лимита времени, то она будет принудительно
остановлена клиентским терминалом.
6.2.3.3 Специальная функция deinit().
Собственным свойством специальной функции deinit() является её исполнение при
закрытии (деинициализации) программы. Если в программе есть описание специальной
функции deinit(), то она будет вызвана (и исполнена) в момент закрытия программы. Если
в программе нет специальной функции deinit(), то при закрытии программы не
выполняется никаких действий.
Специальная функция deinit() вызывается для исполнения клиентским терминалом также
при завершении работы клиентского терминала, при закрытии окна финансового
инструмента, непосредственно перед сменой финансового инструмента и/или периода
графика, при удачной перекомпиляции программы в редакторе MetaEditor, при смене
входных параметров, а также при смене счета.
В экспертах и скриптах закрытие программы с необходимостью вызова специальной
функции deinit() происходит и по причине присоединения к окну финансового
инструмента новой программы того же вида, замещающей предыдущую.
В пользовательских индикаторах исполнение специальной функции deinit() в результате
присоединения к графику нового индикатора не происходит. В окне финансового
инструмента может работать одновременно несколько различных индикаторов, поэтому
присоединение к окну финансового инструмента нового индикатора не приводит к
закрытию других индикаторов с необходимостью вызова на исполнение функции deinit().
Время исполнения специальной функции deinit() ограничено периодом 2,5 секунды. В
случае, если код, заложенный в специальную функцию deinit(), выполняется дольше
указанного времени, то клиентский терминал принудительно завершит работу
специальной функции deinit() и программы в целом.
6.2.4 Требования к специальным функциям
119
Допускается отсутствие в программе специальных функций init() и deinit(). Порядок
следования в программе описаний специальных функций не имеет значения. Специальные
функции могут быть вызваны из любого места программы в соответствии с общим
порядком вызова функции.
Специальные функции могут иметь параметры. Однако при вызове этих функций
клиентским терминалом никакие параметры переданы извне не будут, а будут
использованы умолчательные значения.
Специальные функции init() и deinit() должны по возможности максимально быстро
завершать свою работу и ни в коем случае не зацикливаться в попытке начать
полноценную работу раньше вызова функции start().
6.2.5 Порядок использования специальных функций
Разработчики предоставили в распоряжение программистов очень удобный механизм: при
включении программы в работу прежде всего исполняется init(), после этого вся основная
работа (так долго по времени, сколько нужно пользователю) осуществляется с помощью
функции start(), а когда пользователь завершил работу программы, то ненадолго перед
выгрузкой программы будет запущена функция deinit().
Весь основной код программы должен быть сосредоточен в функции start(). Внутри неё
должны располагаться операторы, обращения к встроенным и пользовательским
функциям, производиться необходимые вычисления. В то же время следует правильно
понимать роль, отведенную пользовательским функциям. Описание пользовательских
функций располагается в коде программы за пределами описаний специальных функций,
но если пользовательская функция вызвана для исполнения, то при этом специальная
функцию свою работу не прекращает. Это значит, что управление на некоторое время
передаётся в пользовательскую функцию, но сама пользовательская функция работает в
рамках исполнения вызвавшей её специальной функции. Поэтому справедливо будет
сказать, что в процессе выполнения программы специальные функции работают всегда
(согласно их собственным свойствам), а пользовательские включаются в работу по мере
их вызова из специальных.
120
В случае если программист не предполагает использовать какую-то из специальных
функций, то он может отказаться от её применения в программе. В этом случае
клиентский терминал её вызывать не будет. Абсолютно нормальной следует считать
программу, содержащую все три специальные функции. Нормальной также можно
считать программу, в которой отсутствуют функции init() или deinit() или одновременно
обе эти функции.
Если в программе не используется ни одна специальная функция, то такая программа не
будет работать. Клиентским терминалом запускаются на исполнение только специальные
функции в соответствии с их свойствами. Пользовательские функции клиентским
терминалом не вызываются. Поэтому, если программа не содержит ни одной специальной
функции (а содержит только пользовательские), то она никогда не будет вызвана для
исполнения.
Нежелательно из специальной функции init() вызывать специальную функцию start() или
совершать торговые операции, так как в момент инициализации модуля могут быть не
готовы значения параметров информационного окружения (данные графиков, рыночные
цены и пр.).
В разделах Выполнение программы и Примеры реализации представлено несколько
практических примеров, на которых можно проследить некоторые свойства специальных
функций.
6.3 Выполнение программы
Развитие навыков программирования происходит лучше всего, если в распоряжении
программиста есть небольшая работающая программа. Для того, чтобы она стала в полной
мере понятной, необходимо внимательно рассмотреть все её составляющие и по шагам
проследить как она работает. Обратите внимание, свойства специальных функций
прикладных программ разных видов (эксперт, скрипт, индикатор) имеют отличия. Здесь
мы рассмотрим, как работает простой эксперт.
Пример простого эксперта (simple.mq4)
//--------------------------------------------------------------------
// simple.mq4