Ковалев Сергей. Программирование на алгоритмическом языке MQL4
Подождите немного. Документ загружается.
211
3.2. Управление передаётся оператору:
Comment("Поступил тик № ",Tick); // Сообщение, содержащее номер
Исполнение стандартной функции Comment() приведёт к появлению сообщения:
Поступил тик № 1
3.3. Управление передаётся оператору:
return; // Оператор выхода из start()
В результате его исполнения специальная функция start() заканчивает свою работу,
управление передаётся клиентскому терминалу. При этом глобальная переменная
продолжает своё существование, её значение сохраняется равным 1.
Далее события будут повторяться, начиная с пункта 2. Переменная Tick снова будет
участвовать в вычислениях, однако на втором тике, в момент запуска на исполнение
функции start(), её значение равно 1, поэтому результатом исполнения оператора:
Tick++; // Счётчик тиков
будет новое значение переменной Tick - оно увеличится на 1 и теперь будет равно 2,
поэтому исполнение функции Comment() приведёт к появлению сообщения:
Поступил тик № 2
Таким образом, значение переменной Tick будет увеличиваться на 1 при каждом запуске
специальной функции start(), т.е. на каждом тике. Решение подобных задач становится
возможным только в случае использования переменных, сохраняющих своё значение
после выхода из функции (в данном случае использована глобальная переменная).
Использовать для той же цели локальные переменные бессмысленно: локальная
переменная теряет своё значение по окончании исполнения функции, в которой она
объявлена.
В этом очень легко убедиться, запустив на выполнение эксперт, в котором переменная
Tick открыта как локальная переменная (т.е. программа содержит алгоритмическую
ошибку):
int start() // Специальная функция start()
{
int Tick; // Локальная переменная
212
Tick++; // Счётчик тиков
Comment("Поступил тик № ",Tick); // Сообщение, содержащее номер
return; // Оператор выхода из start()
}
С точки зрения синтаксиса в представленном коде ошибок нет. Эта программа может быть
успешно скомпилирована и запущена на исполнение. И она будет работать, однако всё
время будет сообщать один и тот же результат:
Поступил тик № 1
И это вполне естественно, потому что переменная Tick будет инициализирована нолём в
начале исполнения специальной функции start() при каждом её запуске. Последующее
увеличение этого значения на единицу будет приводить лишь к тому, что к моменту
сообщения значение Tick всякий раз будет равно 1.
8.2.2 Статические переменные
На физическом уровне локальные переменные представлены во временной области
памяти соответствующей функции. Существует способ расположить переменную,
объявленную внутри функции, в постоянной памяти программы. Для этого при
объявлении переменной перед типом переменной необходимо указать модификатор static:
static int Number; // Статическая переменная целого типа
Ниже представлено решение задачи 22 с использованием статической переменной
(эксперт staticvar.mq4):
//--------------------------------------------------------------------
// staticvar.mq4
// Предназначен для использования в качестве примера в учебнике MQL4.
//--------------------------------------------------------------------
int start() // Специальная функция start()
{
static int Tick; // Статическая локальная перем
Tick++; // Счётчик тиков
Comment("Поступил тик № ",Tick); // Сообщение, содержащее номер
return; // Оператор выхода из start()
}
//--------------------------------------------------------------------
213
Статические переменные инициализируются однократно. Каждая статическая переменная
может быть проинициализирована соответствующей ее типу константой (в отличие от
простой локальной переменной, которая может быть проинициализирована любым
выражением). Если явной инициализации нет, то статическая переменная
инициализируется нулем. Статические переменные хранятся в постоянной области памяти
программы, их значения не теряются при выходе из функции. Вместе с тем, статические
переменные имеют ограничение, свойственное локальным переменным - областью
видимости статической переменной остаётся функция, внутри которой эта переменная
объявлена, в отличие от глобальных переменных, значение которых доступно из любого
места программы. Легко увидеть, что программы countticks.mq4 и staticvar.mq4 дают
одинаковый результат.
Все массивы являются статическими изначально, т.е. имеют вид static, даже если при
инициализации это явно не указано (см. Массивы).
8.2.3 Внешние переменные
Внешняя переменная - это переменная, значение которой доступно из окна свойств
программы. Внешняя переменная объявляется за пределами всех функций и является
глобальной, область её видимости - вся программа. При объявлении внешней переменной
перед типом её значения необходимо указать модификатор extern:
extern int Number; // Внешняя переменная целого
типа
Внешние переменные указываются в головной части программы, а именно перед любой
функцией, в которой имеется обращение к внешней переменной. Использование внешних
переменных очень удобно, если время от времени возникает необходимость запустить
программу на выполнение с иными значениями переменных.
Задача 23. Составить программу, в которой реализуются следующие
условия: если цена достигла некоторого уровня Level и опустилась ниже
этого уровня на n пунктов, то один раз сообщить об этом факте трейдеру.
Понятно, что поставленная задача предполагает необходимость изменения настроек, ведь
сегодня цены уже не такие, как вчера, а завтра будут не такими, как сегодня. Чтобы
214
обеспечить возможность изменения настроек в эксперте externvar.mq4 использованы
внешние переменные:
//--------------------------------------------------------------------
// externvar.mq4
// Предназначен для использования в качестве примера в учебнике MQL4.
//--------------------------------------------------------------------
extern double Level = 1.2500; // Внешняя переменная
extern int n = 5; // Внешняя переменная
bool Fact_1 = false; // Глобальная перемен.
bool Fact_2 = false; // Глобальная перемен.
//--------------------------------------------------------------------
int start() // Спец. функция start
{
double Price = Bid; // Локальная перемен.
if (Fact_2==true) //Если сообщение уже..
return; //..было, то выходим
if (NormalizeDouble(Price,Digits) >= NormalizeDouble(Level,Digits))
Fact_1 = true; // Произошло событие 1
if (Fact_1 == true && NormalizeDouble(Price,Digits)<=
NormalizeDouble(Level-n*Point,Digits))
My_Alert(); // Вызов польз. ф-ии
return; // Выход из start()
}
//--------------------------------------------------------------------
void My_Alert() // Пользовательс. ф-ия
{
Alert("Условия достигнуты"); // Сообщение
Fact_2 = true; // Произошло событие 2
return; // Выход из польз.ф-ии
}
//--------------------------------------------------------------------
В этой программе внешние переменные заданы в строках:
extern double Level = 1.2500; // Внешняя переменная
extern int n = 1; // Внешняя переменная
Значения внешних переменных доступны из окна свойств программы. Ценность этих
переменных состоит в том, что их можно изменить в любой момент - и на этапе
присоединения программы в окно финансового инструмента и в процессе работы
программы.
215
Рис. 54. Окно свойств программы; здесь можно изменить значения переменных.
В момент присоединения программы к окну финансового инструмента в окне настроек
будут указаны те значения переменных, которые указаны в коде программы.
Пользователь может по своему усмотрению изменить эти значения. С момента, когда
пользователь нажал кнопку ОК на панели настроек, программа будет запущена
клиентским терминалом на исполнение. При этом начальные значения внешних
переменных будут такими, какими они были указаны пользователем. В процессе работы
программы значения этих переменных могут быть изменены выполняющейся
программой.
Если у пользователя возникла необходимость поменять значения внешних переменных в
процессе работы программы, то необходимо открыть окно настроек и внести изменения.
Очень важно помнить, что панель свойств программы может быть вызвана на экран
только в период, когда программа (эксперт или индикатор) находится в состоянии
ожидания нового тика, т.е. ни одна из специальных функций не исполняется. В течение
времени исполнения программы панель её свойств вызвана быть не может. Поэтому, если
программа составлена таким образом, что выполняется долго (несколько секунд или
десятков секунд), то у пользователя могут возникнуть затруднения с доступом к окну
свойств программы. Значения внешних переменных скрипта доступны только в момент
его присоединения к окну финансового инструмента, но в процессе работы не могут быть
изменены. Если окно свойств программы открыто, то эксперт не работает - управление
удерживается клиентским терминалом и не передаётся программе для запуска
специальных функций.
216
Обратите внимание, в период, когда открыто окно свойств эксперта и
пользователь принимает решение о значениях внешних переменных,
эксперт (или индикатор) не работает. Установив значения внешних
переменных и нажав ОК на панели настроек программы, пользователь
заново запускает её в работу.
При этом клиентский терминал последовательно запускает на исполнение специальную
функцию deinit(), потом специальную функцию init(), а после этого, в момент поступления
нового тика, запускает на исполнение специальную функцию start(). При исполнении
функции deinit(), завершающей программу, внешние переменные будут иметь значения,
полученные в предыдущем сеансе, т.е. те, которые были у них до открытия панели
настроек эксперта. Перед исполнением специальной функции init() внешние переменные
получат значения, установленные пользователем на панели настроек эксперта, и при
исполнении функции init() внешние переменные будут иметь уже новые, установленные
пользователем значения. Таким образом, новые значения внешних переменных вступают
в силу с момента нового сеанса (init - start - deinit) работы эксперта, начинающегося с
исполнения init().
Факт открытия окна настроек эксперта на значения глобальных переменных не влияет. В
течение всего времени, пока открыто окно настроек, и после его закрытия, глобальные
переменные сохраняют свои значения, имеющиеся на момент, предшествующий
открытию панели настроек эксперта.
В программе externvar.mq4 используются также две глобальные и одна локальная
переменные.
bool Fact_1 = false; // Глобальная перемен.
bool Fact_2 = false; // Глобальная перемен.
double Price = Bid; // Локальная перемен.
Алгоритмически решение задачи выглядит так. Идентифицируются два события: первое -
факт достижения ценой уровня Level, второе - факт того, что сообщение (о снижении
ниже уровня Level на n пунктов) уже выдано. Эти события находят своё отражение в
значениях переменных Fact_1 и Fact_2: если событие ещё не свершилось, то значение
соответствующей переменной равно false, а если свершилось - true. В строках:
if (NormalizeDouble(Price,Digits) >= NormalizeDouble(Level,Digits))
Fact_1 = true; // Произошло событие 1
217
определяется факт свершения первого события. Стандартная функция NormalizeDouble()
позволяет производить вычисления со значениями действительных переменных с
заданной точностью (соответствующей точности цены финансового инструмента). Если
цена оказалась равной или выше заданного уровня, то факт первого события считается
свершившимся, поэтому глобальной переменной Fact_1 присваивается значение истина.
Программа составлена так, что переменная Fact_1, получив однажды значение истина,
никогда не изменит его на ложь - для этого в программе нет соответствующего кода.
В строках:
if (Fact_1 == true && NormalizeDouble(Price,Digits)<=
NormalizeDouble(Level-n*Point,Digits))
My_Alert(); // Вызов польз. ф-ии
определяется необходимость выдачи сообщения. Если уже свершилось первое событие и
цена опустилась на n пунктов ниже (меньше или равно) заданного уровня, то необходимо
выдать сообщение - осуществляется вызов на исполнение пользовательской функции
My_Alert(). В пользовательской функции, после собственно сообщения, отмечается факт
того, что сообщение уже выдано, путём присвоения глобальной переменной Fact_2
значения true. После этого заканчивает работу пользовательская функция и вслед за ней и
специальная функция start().
После того, как переменная Fact_2 получает значение истина, программа всякий раз будет
завешать свою работу, поэтому сообщение, однажды сделанное, больше никогда в
течение этого сеанса работы программы не повторится:
if (Fact_2==true) //Если сообщение уже..
return; //..было, то выходим
Показательным в этой программе является то, что значения глобальных переменных
могут быть изменены в любом месте (и в специальной функции и в пользовательской) и
сохраняются в течение всего периода работы программы - в период между тиками, после
изменения значений внешних переменных или в результате переключения таймфрейма.
В общем случае значения глобальных переменных могут быть изменены в любой
специальной функции. Поэтому нужно быть особенно внимательным, указывая
операторы, изменяющие значения глобальных переменных в функциях init() и deinit().
Например, если в функции init() обнулить значение глобальной переменной, то при
первом исполнении функции start() значение этой переменной будет нулевым, т.е.
218
значение этой переменной, достигнутое в период предыдущего исполнения start(), будет
потеряно (т.е. после изменения внешних настроек программы).
8.3 Переменные GlobalVariables
В клиентском терминале может работать несколько прикладных программ одновременно.
В ряде случаев возникает необходимость передать какие-то сведения из одной программы
в другую. Специально для этого в языке MQL4 созданы глобальные переменные
клиентского терминала.
Глобальная переменная клиентского терминала - переменная, значение которой доступно
из всех прикладных программ, запущенных на клиентском терминале (сокращённо - GV-
переменная).
Обратите внимание, глобальная переменная клиентского терминала и
глобальная переменная - это разные переменные с похожими
названиями. Областью видимости глобальных переменных является одна
программа, в которой эта переменная объявлена, а областью видимости
глобальных переменных клиентского терминала - все программы,
одновременно запущенные в клиентском терминале.
8.3.1 Свойства GV-переменных
В отличие от других переменных, GV-переменная может быть не только создана из любой
программы, но и удалена. Значение GV-переменной сохраняется на жёстком диске
компьютера и после закрытия клиентского терминала. Однажды объявленная GV-
переменная существует в клиентском терминале в течение 4 недель с момента последнего
обращения. Если в течение указанного срока ни одна из программ не обращалась к GV-
переменной, то она удаляется клиентским терминалом. GV-переменная может иметь
только тип double.
8.3.2 Функции для работы с GV-переменными
219
Для работы с GV-переменными в MQL4 имеются ряд функций (см. также Глобальные
переменные GlobalVariables). Рассмотрим те из них, которые понадобятся нам в
последующих примерах.
8.3.3 Функция GlobalVariableSet()
datetime GlobalVariableSet( string name, double value)
Функция устанавливает новое значение глобальной переменной. Если переменная не
существует, то система создает новую глобальную переменную. При успешном
выполнении функция возвращает время последнего доступа, иначе 0. Чтобы получить
информацию об ошибке, необходимо вызвать функцию GetLastError().
Параметры:
name - Имя глобальной переменной.
value - Новое числовое значение.
8.3.4 Функция GlobalVariableGet()
double GlobalVariableGet( string name)
Функция возвращает значение существующей глобальной переменной или 0 в случае
ошибки. Чтобы получить информацию об ошибке, необходимо вызвать функцию
GetLastError().
Параметры:
name - Имя глобальной переменной.
8.3.5 Функция GlobalVariableDel()
bool GlobalVariableDel( string name)
Функция удаляет глобальную переменную. При успешном удалении функция возвращает
TRUE, иначе FALSE. Чтобы получить информацию об ошибке, необходимо вызвать
функцию GetLastError().
Параметры:
220
name - Имя глобальной переменной.
Чтобы продемонстрировать насколько удобным и полезным может быть использование
GV-переменных, решим следующую задачу:
Задача 24. В терминале одновременно работают несколько экспертов.
Сумма депозита составляет $10 000. Общая стоимость всех открытых
ордеров не должна превышать 30% от суммы депозита. Каждому
эксперту должно быть выделено равное количество денежных средств.
Составить программу эксперта, содержащую расчёт суммы, выделенной
для торговли.
Собственно расчёт суммы, которая выделяется эксперту для торговли, не представляет
никакой сложности. Однако, для того, чтобы такой расчёт выполнить, необходимо знать,
какое количество экспертов одновременно запущено в клиентском терминале. В MQL4 не
существует функции, которая помогла бы ответить на этот вопрос. Единственная
возможность для подсчёта количества одновременно запущенных программ состоит в
том, чтобы каждая из программ заявила о себе путём изменения значения некоторой GV-
переменной. В дальнейшем, все программы, заинтересованные в такой информации,
могут обратиться к этой переменной и по её значению судить о текущем положении дел.
Здесь нужно заметить, что в общем случае не каждая программа предназначена для
решения подобной задачи. Если в клиентском терминале появится эксперт, не
заявляющий о своём присутствии, то, естественно, он никак не будет учтён. Поэтому в
данном случае сама постановка задачи предполагает использование только тех экспертов,
которые содержат необходимый код - и для изменения значения GV-переменной, и для
последующего считывания значения этой переменной.
Ниже представлен эксперт, демонстрирующий использование GV-переменных
(globalvar.mq4), который может быть использован для решения Задачи 24:
//--------------------------------------------------------------------
// globalvar.mq4
// Предназначен для использования в качестве примера в учебнике MQL4.
//--------------------------------------------------------------------
int Experts; // Колич. экспертов
double Depo=10000.0, // Заданный депозит