Ковалев Сергей. Программирование на алгоритмическом языке MQL4
Подождите немного. Документ загружается.
101
Во-первых, комментарии позволяют отделить одну логически обособленную часть
программы от другой. Гораздо легче читать удобно форматированный текст, нежели
текст, составленный сплошным потоком.
Во-вторых, построчные комментарии позволяют пояснить обычными словами, что имел
ввиду программист в каждой отдельно взятой строке кода.
В-третьих, в верхней части программы можно указать некоторый набор сведений,
касающихся программы в целом: фамилию и реквизиты автора (в том числе, авторский
сайт, адрес электронной почты и пр.), назначение программы (является она законченной
торгующей программой или библиотечной функцией), основные её характеристики и
ограничения, а также другую полезную информацию на усмотрение автора.
Каждый программист по своему вкусу может выбрать любой удобный ему стиль
комментариев. Стиль, предлагаемый разработчиками языка MQL4, представлен в эксперте
create.mq4. Рассмотрим основные особенности любого приемлемого стиля оформления
программы.
1. Длина строки кода не должна превышать размер основного окна. Это ограничение не
является формальным требованием синтаксиса языка, однако чтение программы,
содержащей длинные строки, очень неудобно. Любую длинную строку всегда можно
расположить в несколько программных строк, так, чтобы все они были полностью видны
на экране. Для монитора с разрешением 1024 х 768 пикселей максимальная длина строки
составляет 118 символов.
2. Объявление переменных осуществляется в начале программы. К каждой переменной
желательно дать описание в комментарии: кратко отметить сущность и (если необходимо)
особенности использования переменной.
3. Каждый оператор желательно располагать в отдельной строке.
4. Построчный комментарий, если он присутствует в строке, должен начинаться с 76
позиции (рекомендуется для мониторов 17" с разрешением 1024 х 768 пикс.). Это
требование также не является обязательным. Например, если строка кода занимает 80
позиций, то её не обязательно разбивать на две строки, можно написать комментарий,
начиная с 81 позиции. Обычно содержательная часть программы (код) составляют строки
длиной около 50 символов, поэтому построчный комментарий выглядит как столбец
текста в правой части экрана.
102
5. Для разделения логически обособленных фрагментов используются строки
комментария на всю ширину (118 символов).
6. При использовании фигурных скобок обязательно используется отступ на величину
табуляции (обычно 3 символа).
Посмотрим? как может выглядеть эксперт после того, как в него вписан программный
код. В данном случае логика программного алгоритма не обсуждается. Здесь важно
отметить только подробности оформления программы. Комментированная программа
(эксперт create.mq4) может выглядеть, например, так:
//--------------------------------------------------------------------
// create.mq4
// Предназначен для использования в качестве примера в учебнике MQL4.
//--------------------------------------------------------------------
int Count=0; // Глобальная перемен.
//--------------------------------------------------------------------
int init() // Спец. ф-ия init()
{
Alert ("Сработала ф-ия init() при запуске"); // Сообщение
return; // Выход из init()
}
//--------------------------------------------------------------------
int start() // Спец. ф-ия start()
{
double Price = Bid; // Локальная перемен.
Count++; // Счётчик тиков
Alert("Новый тик ",Count," Цена = ",Price);// Сообщение
return; // Выход из start()
}
//--------------------------------------------------------------------
int deinit() // Спец. ф-ия deinit()
{
Alert ("Сработала ф-ия deinit() при выгрузке"); // Сообщение
return; // Выход из deinit()
}
//--------------------------------------------------------------------
Легко увидеть, что законченные смысловые блоки программы отделены друг от друга
комментарием - сплошной строкой. Таким способом выделяются специальные,
пользовательские функции и головная часть программы:
//--------------------------------------------------------------------
103
Объявление переменных выполняется в отдельном блоке, причём каждая переменная
описана. Иногда в программе используются переменные, для объяснения смысла которых
приходится использовать комментарий в несколько строк. Такое случается редко, но при
необходимости делать это нужно обязательно, иначе не только другой программист, но и
автор программы не сможет в ней разобраться по прошествии некоторого срока.
В правой части каждой строки кода дан поясняющий комментарий. Ценность
комментариев становится понятной только в том случае, если их нет, и при чтении
программы возникают проблемы с пониманием алгоритма. Например, если этот же код
представить без комментариев и без выделения блоков с помощью табуляции, то, даже
несмотря на то, что программа достаточно простая и короткая, воспринимать её станет
значительно сложнее:
int Count=0
;
int init() {
Alert ("Сработала ф-ия init() при запуске");
return; }
int start() {
double Price = Bid
;
Count++;
Alert("Новый тик ",Count," Цена = ",Price);
return; }
int deinit(){
Alert ("Сработала ф-ия deinit() при выгрузке");
return;}
5.2.4 Компиляция программы
Чтобы программу можно было использовать на практике, её необходимо скомпилировать.
Для этого нужно воспользоваться кнопкой
(F5) в редакторе MetaEditor.
Если в программе нет ошибок, то программа будет скомпилирована, а в окне
инструментария появится сообщение:
Рис. 29. Сообщение редактора об успешной компиляции программы.
104
При этом в соответствующем каталоге (в данном случае в Каталог_терминала\experts)
появится новый файл create.ex4. Это - программа, готовая к работе в клиентском
терминале MetaTrader 4. В момент компиляции в том же каталоге сохранится также
последняя редакция исходного текста программы с тем же названием, в нашем случае -
это файл create.mq4.
Одновременно с этим в окне навигатора клиентского терминала, в разделе Советники
появится строка с названием созданного эксперта:
Рис. 30. Отображение названия эксперта в окне навигатора клиентского терминала.
Если при компиляции в программе будут обнаружены ошибки, то редактор MetaEditor
выдаст соответствующее сообщение об ошибке. В таком случае необходимо вернуться к
редактированию исходного текста программы, исправить ошибки и попытаться снова
скомпилировать программу. Успешная компиляция программы возможна только в случае,
если в ней нет ошибок.
5.2.5 Использование программы в практической работе
Если прикладная программа (эксперт, скрипт, индикатор) успешно скомпилирована и её
название появилось в окне навигатора клиентского терминала, то её можно использовать в
практической работе. Для этого достаточно мышкой перетащить соответствующий значок
из окна навигатора в окно финансового инструмента. Это будет означать, что программа
присоединена к окну графика финансового инструмента и будет запущена на исполнение.
105
Эксперт и индикатор будут оставаться в работе до тех пор, пока пользователь вручную не
прекратит работу программы. Обычный скрипт, после выполнения заложенного в него
алгоритма, самостоятельно прекратит свою работу.
Здесь необходимо ещё раз подчеркнуть, что:
Любые прикладные программы (эксперт, скрипт, индикатор) могут быть
использованы для торговли только в составе клиентского терминала
MetaTrader 4 при условии его подключения к серверу (дилинговому
центру) с помощью сети Интернет; никакие программы не могут быть
установлены пользователем на сервере или использоваться в терминалах
других производителей.
Иными словами, если трейдер хочет использовать в своей работе какую-либо прикладную
программу, он должен включить свой компьютер, открыть клиентский терминал
MetaTrader 4 и запустить в окне финансового инструмента исполняемый файл *.ex4. При
исполнении программы (в зависимости от её алгоритма) могут быть сформированы
торговые приказы, которые будут отправлены на сервер, в результате чего и будет
осуществляться управление торговлей.
106
6 Программа на MQL4
С самого начала следует заметить, что программирование на языке MQL4 вполне по
силам обычному человеку, хотя и требует внимания и определённых знаний.
Некоторые трейдеры, возможно, мысленно готовятся к затруднениям при обучении
программированию, имея в виду, что они лишь с большим трудом могут представить
сложные процессы, происходящие в недрах их компьютеров. К счастью, разработчики
языка MQL4 постарались сделать его доступным широкому кругу пользователей.
Приятная особенность составления программ на MQL4 состоит в том, что от
программиста не требуется специальных знаний, касающихся взаимодействия
клиентского терминала с операционной средой, особенностей сетевых протоколов или
устройства компилятора.
Процесс составления программ на MQL4 - это выполнение простой и понятной работы.
Например, водителю автомобиля необязательно уметь разбираться в устройстве
двигателя, чтобы ездить на автомобиле, - достаточно научиться давить на педали и
крутить руль. Вместе с тем, каждый водитель, прежде чем выехать на дорогу с
оживлённым движением, проходит обучение. Приблизительно то же необходимо сделать
и начинающему программисту - освоить некоторые простые принципы построения
программ, и - можно начинать потихоньку "ездить".
6.1 Структура программы
Ранее мы ознакомились с основными понятиями, на которых базируется язык
программирования MQL4. Теперь необходимо рассмотреть, как устроена программа в
целом. Изучая этот вопрос, мы рассмотрим её структурную схему.
Как уже упоминалось, основной код программы, составленный программистом,
располагается внутри пользовательских и специальных функций. В разделе Функции мы
рассматривали понятие и свойства встроенных и пользовательских функций. Кратко
напомним, что пользовательская функция имеет описание, а для запуска её на исполнение
в программе используется вызов функции. Любая встроенная или пользовательская
функция может быть исполнена только в результате обращения к ней; в этом случае
говорят, что функция вызвана для исполнения программой.
107
Свойства специальных функций подробно изложены в разделе Специальные функции, а
здесь мы рассмотрим только общие сведения о них. Специальная функция - это такая
функция, которая вызывается для исполнения клиентским терминалом. В отличие от
обычных функций, специальные функции имеют только описание, а вызов специальных
функций в программе не указывается. Специальные функции вызываются для исполнения
клиентским терминалом (имеется техническая возможность вызова специальных функций
и из программы, но мы будем считать такой способ некорректным и здесь рассматривать
не будем). Когда программа запущена на исполнение в окне финансового инструмента,
клиентский терминал передаёт управление одной из специальных функций, в результате
чего эта функция исполняется.
Правило программирования на языке MQL4 состоит в следующем:
Код программы должен быть расположен внутри функций.
Это значит, что программные строки (операторы и обращения к функциям), находящиеся
за пределами функций, не могут быть исполнены. При попытке компиляции такой
программы редактор MetaEditor выдаст соответствующее сообщение об ошибке, и
исполняемый файл *.ехе в результате компиляции получен не будет.
Рассмотрим функциональную схему обычной прикладной программы-эксперта:
108
Рис. 31. Функциональная схема программы (эксперта).
Наиболее крупными функциональными блоками составленной на MQL4 программы
являются:
1. Головная часть программы.
2. Специальная функция init().
3. Специальная функция start().
4. Специальная функция deinit().
5. Пользовательские функции.
В дальнейшем мы будем рассматривать только внутреннее содержание этих
функциональных блоков (составных частей) программы, а все внешние объекты, будь то
109
информационная среда клиентского терминала или оборудование, не будут входить в круг
наших интересов.
6.1.1 Информационная среда клиентского терминала МТ4
Информационная среда клиентского терминала МТ4 не является составной частью
программы. Информационная среда - это набор параметров, доступных для обработки
программой. Например, это - пришедшая с новым тиком цена финансового инструмента,
накапливающийся с каждым новым тиком объём, сведения о максимальных и
минимальных ценах исторических баров, параметры, характеризующие предлагаемые
дилинговым центром условия торговли и т.д. Информационная среда постоянно
сохраняется и с каждым новым тиком обновляется клиентским терминалом,
поддерживающим постоянную связь с сервером.
6.1.2 Структура программы
6.1.2.1 Головная часть
Головная часть - это несколько строк программы, расположенных в её начале (буквально -
в первой, второй строке и т.д.), содержащих некоторые записи. В этих строках
размещается информация общего характера, касающаяся программы в целом. Например, в
головной части располагаются строки объявления и инициализации глобальных
переменных (необходимость расположения той или иной информации в головной части
программы будет рассмотрена ниже). Признаком окончания головной части может
служить встретившееся в следующей строке описание функции (пользовательской или
специальной).
6.1.2.2 Специальные функции
Обычно после головной части следует описание специальных функций. Внешне описание
специальной функции выглядят так же, как и описание обычной пользовательской
функции, с той разницей, что специальные функции имеют предопределённые имена -
110
init(), start() и deinit(). Специальные функции представляют собой собственно блок
вычислений и находятся во взаимоотношениях с информационной средой клиентского
терминала и пользовательскими функциями. Специальные функции подробно
рассматриваются в разделе Специальные функции.
6.1.2.3 Пользовательские функции
Описания пользовательских функций обычно располагаются непосредственно после
описания специальных функций. Количество пользовательских функций в программе не
ограничено. На схеме представлены всего две пользовательские функции, в то время как в
программе их может быть 10 или 500, или ни одной. Если в программе не применяются
пользовательские функции, значит, программа будет иметь упрощённый вид: головную
часть и описания специальных функций.
6.1.2.4 Стандартные функции
Ранее упоминалось, что стандартные функции могут быть представлены только в виде
вызова функции. Вообще говоря, стандартная функция, как и специальные и
пользовательские функции, имеет описание. Однако это описание не указывается в
программе (поэтому и не показано на схеме). Описание стандартной функции скрыто от
глаз программиста, его невозможно изменить, но оно доступно редактору MetaEditor. В
период компиляции программы редактор MetaEditor сформирует такой исполняемый
файл, в котором в полной мере правильно будут исполняться все вызываемые
стандартные функции.
6.1.3 Порядок расположения в программе
Головная часть программы должна находиться в первых строках. Порядок расположения
в программе описаний специальных и пользовательских функций не имеет значения. На
рис. 32 представлена обычная последовательность функциональных блоков, а именно -
головная часть, специальные функции, пользовательские функции. На рис. 33
представлены другие варианты структуры программы. Во всех примерах головная часть