Язык программирования MQL4

Подождите немного. Документ загружается.

Рис. 54. Окно свойств программы; здесь можно изменить значения переменных.

В момент присоединения программы к окну финансового инструмента в окне настроек

будут указаны те значения переменных, которые указаны в коде программы.

Пользователь может по своему усмотрению изменить эти значения. С момента, когда

пользователь нажал кнопку ОК на панели настроек, программа будет запущена

клиентским терминалом на исполнение. При этом начальные значения внешних

переменных будут такими, какими они были указаны пользователем. В процессе работы

программы значения этих переменных могут быть изменены выполняющейся

программой.

Если у пользователя возникла необходимость поменять значения внешних переменных в

процессе работы программы, то необходимо открыть окно настроек и внести изменения.

Очень важно помнить, что панель свойств программы может быть вызвана на экран

только в период, когда программа (эксперт или индикатор) находится в состоянии

ожидания нового тика, т.е. ни одна из специальных функций не исполняется. В течение

времени исполнения программы панель её свойств вызвана быть не может. Поэтому, если

программа составлена таким образом, что выполняется долго (несколько секунд или

десятков секунд), то у пользователя могут возникнуть затруднения с доступом к окну

свойств программы. Значения внешних переменных скрипта доступны только в момент

его присоединения к окну финансового инструмента, но в процессе работы не могут быть

изменены. Если окно свойств программы открыто, то эксперт не работает - управление

удерживается клиентским терминалом и не передаётся программе для запуска

специальных функций.

211

Обратите внимание, в период, когда открыто окно свойств эксперта и

пользователь принимает решение о значениях внешних переменных,

эксперт (или индикатор) не работает. Установив значения внешних

переменных и нажав ОК на панели настроек программы, пользователь

заново запускает её в работу.

При этом клиентский терминал последовательно запускает на исполнение специальную

функцию 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

212

определяется факт свершения первого события. Стандартная функция 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() значение этой переменной будет нулевым, т.е.

значение этой переменной, достигнутое в период предыдущего исполнения start(), будет

потеряно (т.е. после изменения внешних настроек программы).

213

8.3 Переменные GlobalVariables

В клиентском терминале может работать несколько прикладных программ одновременно.

В ряде случаев возникает необходимость передать какие-то сведения из одной программы

в другую. Специально для этого в языке MQL4 созданы глобальные переменные

клиентского терминала.

Глобальная переменная клиентского терминала - переменная, значение которой доступно

из всех прикладных программ, запущенных на клиентском терминале (сокращённо - GV-

переменная).

Обратите внимание, глобальная переменная клиентского терминала и

глобальная переменная - это разные переменные с похожими

названиями. Областью видимости глобальных переменных является

одна программа, в которой эта переменная объявлена, а областью

видимости глобальных переменных клиентского терминала - все

программы, одновременно запущенные в клиентском терминале.

8.3.1 Свойства GV-переменных

В отличие от других переменных, GV-переменная может быть не только создана из любой

программы, но и удалена. Значение GV-переменной сохраняется на жёстком диске

компьютера и после закрытия клиентского терминала. Однажды объявленная GV-

переменная существует в клиентском терминале в течение 4 недель с момента последнего

обращения. Если в течение указанного срока ни одна из программ не обращалась к GV-

переменной, то она удаляется клиентским терминалом. GV-переменная может иметь

только тип double.

8.3.2 Функции для работы с GV-переменными

214

Для работы с 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().

Параметры:

name - Имя глобальной переменной.

215

Чтобы продемонстрировать насколько удобным и полезным может быть использование

GV-переменных, решим следующую задачу:

Задача 24. В терминале одновременно работают несколько экспертов.

Сумма депозита составляет $10 000. Общая стоимость всех открытых

ордеров не должна превышать 30% от суммы депозита. Каждому

эксперту должно быть выделено равное количество денежных средств.

Составить программу эксперта, содержащую расчёт суммы,

выделенной для торговли.

Собственно расчёт суммы, которая выделяется эксперту для торговли, не представляет

никакой сложности. Однако, для того, чтобы такой расчёт выполнить, необходимо знать,

какое количество экспертов одновременно запущено в клиентском терминале. В MQL4 не

существует функции, которая помогла бы ответить на этот вопрос. Единственная

возможность для подсчёта количества одновременно запущенных программ состоит в

том, чтобы каждая из программ заявила о себе путём изменения значения некоторой GV-

переменной. В дальнейшем, все программы, заинтересованные в такой информации,

могут обратиться к этой переменной и по её значению судить о текущем положении дел.

Здесь нужно заметить, что в общем случае не каждая программа предназначена для

решения подобной задачи. Если в клиентском терминале появится эксперт, не

заявляющий о своём присутствии, то, естественно, он никак не будет учтён. Поэтому в

данном случае сама постановка задачи предполагает использование только тех экспертов,

которые содержат необходимый код - и для изменения значения GV-переменной, и для

последующего считывания значения этой переменной.

Ниже представлен эксперт, демонстрирующий использование GV-переменных

(globalvar.mq4), который может быть использован для решения Задачи 24:

//--------------------------------------------------------------------

// globalvar.mq4

// Предназначен для использования в качестве примера в учебнике MQL4.

//--------------------------------------------------------------------

int‘‘‘‘Experts;‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘ // Колич. экспертов

double Depo=10000.0,‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Заданный депозит

‘‘‘‘‘‘ Persent=30,‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Заданный процент‘‘‘‘

‘‘‘‘‘‘ Money;‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘ // Искомые средства

string Quantity="GV_Quantity";‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Имя GV-переменной

216

//--------------------------------------------------------------------

int init()‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Спец. функция init

‘‘{

‘‘ Experts=GlobalVariableGet(Quantity);‘‘‘‘‘‘‘‘ // Получим тек. знач.

‘‘ Experts=Experts+1;‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘ // Колич. экспертов

‘‘ GlobalVariableSet(Quantity, Experts);‘‘‘‘‘‘‘‘// Новое значение

‘‘ Money=Depo*Persent/100/Experts;‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Средства для эксп.

‘‘ Alert("Для эксперта в окне ", Symbol()," выделено ",Money);

‘‘ return;‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Выход из init()

‘‘}

//--------------------------------------------------------------------

int start()‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘ // Спец. функция start

‘‘{

‘‘ int New_Experts= GlobalVariableGet(Quantity);// Новое колич. эксп.

‘‘ if (Experts!=New_Experts)‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Если изменилось

‘‘‘‘ {

‘‘‘‘‘‘Experts=New_Experts;‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Теперь текущ. такое

‘‘‘‘‘‘Money=Depo*Persent/100/Experts;‘‘‘‘‘‘‘‘‘‘‘‘ // Новое знач. средств

‘‘‘‘‘‘Alert("Новое значение для эксперта ",Symbol(),": ",Money);

‘‘‘‘ }

‘‘ /*

‘‘ ...

‘‘ Здесь долен быть указан основной код эксперта,

‘‘ в котором используется значение переменной Money

‘‘ ...

‘‘ */

‘‘ return;‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Выход из start()

‘‘}

//--------------------------------------------------------------------

int deinit()‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Спец. ф-ия deinit

‘‘{

‘‘ if (Experts ==1)‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘ // Если эксперт один..

‘‘‘‘‘‘GlobalVariableDel(Quantity);‘‘‘‘‘‘‘‘‘‘‘‘‘‘//..удаляем GV-перемен

‘‘ else‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘ // А иначе..

‘‘‘‘‘‘GlobalVariableSet(Quantity, Experts-1);‘‘ //..уменьшаем на 1

‘‘ Alert("Эксперт выгружен из окна ",Symbol()); // Сообщ. о выгрузке

‘‘ return;‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Выход из deinit()

‘‘}

//--------------------------------------------------------------------

Этот эксперт содержит три специальные функции. Кратко напомним, что все специальные

функции запускаются на исполнение клиентским терминалом: функция init() - при

присоединении эксперта к окну финансового инструмента, функция deinit() - при выгрузке

217

эксперта из окна, а функция start() - потиково. В головной части программы объявлены

глобальные переменные (областью видимости этих переменных является программа).

Распределение средств между экспертами зависит от одного изменяемого параметра -

количества одновременно запущенных экспертов. Поэтому и GV-переменная,

отражающая количество экспертов, должна быть одна. Название этой переменной задано

в строке:

string Quantity = "GV_Quantity"; // Имя GV-переменной

Обратите внимание, имя глобальной переменной клиентского

терминала может быть вычислено в исполняющейся программе (имена

всех других видов переменных задаются программистом на этапе

создания кода).

Разберём подробно, как изменяется и обрабатывается значение переменной Quantity в

процессе выполнения программы. Прежде всего, эксперт, присоединяемый к окну

финансового инструмента, должен заявить о своём присутствии, чтобы другие эксперты,

работающие в терминале, могли об этом событии узнать. Это необходимо сделать как

можно раньше (как можно ближе к тому моменту, когда эксперт присоединён). Наиболее

подходящее для этого место в программе - специальная функция init(). В первой строке

этой функции эксперт запрашивает текущее значение переменной Quantity, для этого

используется функция GlobalVariableGet():

Experts = GlobalVariableGet(Quantity); // Получим тек. знач.

Теперь значение GV-переменной Quantity, каким бы оно ни было на момент

присоединения эксперта, должно быть увеличено на 1. Это означает, что только что

присоединяемый эксперт увеличил общее количество экспертов, одновременно

работающих в терминале, на один:

Experts = Experts+1; // Колич. экспертов

Глобальная переменная Experts используется в программе для удобства. Её значение

недоступно другим экспертам. Чтобы изменить значение GV-переменной Quantity,

необходимо воспользоваться функцией GlobalVariableSet(), устанавливающей новое

значение GV-переменной:

GlobalVariableSet(Quantity, Experts); // Новое значение

218

Это означает, что GV-переменной Quantity присвоено новое значение Experts. Теперь это

новое значение GV-переменной доступно всем работающим в терминале программам.

Вслед за этим рассчитывается и искомая сумма, выделенная для торговли только что

присоединённому эксперту, и делается сообщение (здесь сообщения необходимы только

для того, чтобы проиллюстрировать в какой момент времени в каком эксперте

осуществляются те или иные события; в реально работающей программе сообщения

используются по необходимости).

‘‘ Money = Depo*Persent/100/Experts;‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Средства для эксп.

‘‘ Alert("Для эксперта в окне ", Symbol()," выделено ",Money);

Обратите внимание, наш эксперт рассчитал искомую сумму исходя из общего количества

присоединённых экспертов (в том числе, посчитал и себя). По окончании исполнения

специальной функции init() управление передаётся клиентскому терминалу, и эксперт

переходит в режим ожидания нового тика. В момент прихода нового тика клиентский

терминал запустит на исполнение специальную функцию start().

Теперь, в рамках решения поставленной задачи, целью эксперта является отслеживание

текущего количества присоединённых экспертов - ведь могут быть присоединены или

выгружены другие эксперты, а значит, общее количество одновременно работающих

экспертов может измениться. В зависимости от этого наш эксперт должен пересчитать

сумму средств, выделяемых ему по условию задачи. Поэтому, первое, что делает эксперт

на каждом новом тике, - это запрашивает новое значение GV-переменной Quantity:

int New_Experts= GlobalVariableGet(Quantity);// Новое колич. эксп.

и если это новое значение New_Experts не совпадает с последним известным значением

Experts, то новое известное значение теперь учитывается как текущее, выполняется

пересчёт средств, выделяемых эксперту для торговли (Money), а также делается

соответствующее сообщение:

‘‘ if (Experts != New_Experts)‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Если изменилось

‘‘‘‘ {

‘‘‘‘‘‘Experts = New_Experts;‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Теперь текущ. такое

‘‘‘‘‘‘Money = Depo*Persent/100/Experts;‘‘‘‘‘‘‘‘‘‘ // Новое знач. средств

‘‘‘‘‘‘Alert("Новое значение для эксперта ",Symbol(),": ",Money);

‘‘‘‘ }

Если же переменные New_Experts и Experts совпадают, то этот расчёт не производится, а в

дальнейшем коде эксперта (в функции start()) используется ранее вычисленное значение

219

переменной Money. Так, в зависимости от ситуации, на каждом тике высчитывается новое

или сохраняется имеющееся значение Money.

На этапе выгрузки каждый эксперт, принимающий участие в вычислениях в рамках

Задачи 24, должен сообщить другим экспертам, что он выгружен, т.е. количество

одновременно работающих экспертов уменьшилось. Более того, если этот эксперт

последний, то необходимо удалить и саму GV-переменную. О выгрузке эксперта

однозначно свидетельствует факт исполнения специальной функции deinit(), поэтому

соответствующий код должен быть расположен именно в этой функции:

int deinit() // Спец. ф-ия deinit

{

if (Experts ==1) // Если эксперт один..

GlobalVariableDel(Quantity); //..удаляем GV-перемен

else // А иначе..

GlobalVariableSet(Quantity, Experts-1); //..уменьшаем на 1

Alert("Эксперт выгружен из окна ",Symbol()); // Сообщ. о выгрузке

return; // Выход из deinit()

}

Все вычисления в специальной функции deinit() производятся в рамках одного оператора

if. Если количество экспертов равно 1, т.е. этот эксперт последний, то исполняется

удаление GV-переменной с помощью функции GlobalVariableDel(), а во всех остальных

случаях (т.е. когда количество экспертов больше 1) с помощью функции

GlobalVariableSet() для переменной Quantity устанавливается новое значение, которое на 1

меньше текущего. Эксперты, оставшиеся загруженными, в начале исполнения

специальной функции start(), отследят новое значение переменной Quantity и пересчитают

искомое значение переменной Money.

Легко заметить, что значения GV-переменных могут быть считаны или изменены из

любого исполняющегося эксперта с помощью предназначенных для этого функций.

Прямые вычисления со значениями GV-переменных недопустимы. Для того, чтобы

использовать значение GV-переменной в обычном выражении, необходимо это значение

присвоить какой-нибудь другой переменной, и в вычислениях использовать эту

переменную. В нашем случае такую роль играют две переменные - Experts и New_Experts

в таких строках:

Experts = GlobalVariableGet(Quantity); // Получим тек. знач.

int New_Experts= GlobalVariableGet(Quantity);// Новое колич. эксп.

220