Язык программирования MQL4
Подождите немного. Документ загружается.
Рис. 51. Функциональная схема программы, использующей обращение к функциям.
На функциональной схеме кружками обозначены вызовы функций (пользовательской и
стандартной). Красными стрелками показана передача управления в функцию и обратно.
Наглядно видно, что функция возвращает управление в то место, где указан вызов
функции, причём на пути между вызовом функции и самой функцией не совершается
каких-либо иных вычислений. В общем случае, если функция возвращает значение, это
значение передаётся в вызывающий модуль (по красной стрелке в направлении вызова
функции).
Специальные функции могут быть вызваны из любого места программы по общим
правилам, наравне с другими функциями. Специальные функции также могут иметь
параметры. Однако при вызове этих функций клиентским терминалом никакие параметры
извне переданы не будут, а будут использованы умолчательные значения. Использование
параметров в специальных функциях будет иметь смысл только при вызове их из
программы. Несмотря на то, что в языке MQL4 имеется техническая возможность вызова
специальных функций из программы, делать это не рекомендуется. Программу,
использующую обращение к специальным функциям, следует считать некорректной.
7.9 Описание функции и оператор return
По необходимости указания в программе можно выделить 2 группы функций: функции,
описания которых в программе не указываются, и функции, описания которых должны
быть указаны в программе. Описания стандартных функций в программе не указываются.
191
Описания пользовательских функций должны присутствовать в программе обязательно.
Описания специальных функций, если они используются, также указываются в
программе.
7.9.1 Формат описания функции
Описание функции состоит из двух основных частей - заголовка функции и тела функции.
Заголовок функции содержит указание типа возвращаемого значения, название функции и
список формальных параметров, обрамлённый круглыми скобками. Если функция не
должна возвращать никакого значения, то её тип обозначают void.
Тело функции может состоять из простых и/или составных операторов, обращений к
другим функциям и заключается в фигурные скобки.
Тип_возвращаемого_значения Название_функции (Список формальных
параметров)//Заголовок
{ // Открывающая фигурная скобка
Программный код, // Тело функции может состоять ..
составляющий тело //.. из операторов и ..
функции //.. обращений к другим функциям
} // Закрывающая фигурная скобка
Список параметров указывается через запятую. Количество параметров, передаваемых в
функцию, ограничено и не может превышать 64. В качестве формальных параметров в
заголовке функции могут быть указаны только переменные (но не константы, вызовы
других функций или выражения). Количество, тип и порядок упоминания передаваемых
параметров в вызове функции должны совпадать с количеством, типом и порядком
упоминания формальных параметров, указанных в описании функции (исключение
составляет вызов функции, имеющей параметры со значением по умолчанию):
int My_function (int a, double b) // Пример описания функции
{
int c = a * b + 3; // Оператор тела функции
return (c); // Оператор выхода из функции
}
// Здесь (слева направо в заголовке):
int // Тип возвращаемого значения
My_function // Название функции
int a // Первый формальный параметр а целого типа
double b // Второй формальный параметр b дествит.
типа
192
Параметры, передаваемые в функцию, могут иметь значения по умолчанию, которые
задаются константами соответствующего типа:
int My_function (int a, bool b=true, int c=1, double d=0.5)//Пример описания функции
{
a = a + b*c + d2; // Оператор тела функции
int k = a * 3; // Оператор тела функции
return (k); // Оператор выхода из функции
}
// Здесь (слева направо в заголовке):
int // Тип возвращаемого значения
My_function // Название функции
int a // Первый формальный параметр а целого типа
bool b // Второй формальный параметр b
логическ.типа
true // Константа - умолчательное значение для b
int c // Третий формальный параметр c целого типа
1 // Константа - умолчательное значение для c
double d // Четвёрт. формальный параметр d
действ.типа
0.5 // Константа - умолчательное значение для d
a,b,c,d,k // Локальные переменные
Если в вызове функции, имеющей умолчательные значения, указаны фактические
параметры, то к расчёту в функции будут приняты значения фактических параметров.
Если в вызове функции, имеющей умолчательные значения, не указаны какие-то
фактические параметры, то к расчёту в функции принимаются соответствующие значения
по умолчанию.
Специальные функции также могут иметь параметры. Однако при вызове этих функций
клиентским терминалом никакие параметры извне переданы не будут, а будут
использованы умолчательные значения. Специальные функции могут быть вызваны из
любого места модуля по общим правилам, наравне с другими функциями.
7.9.2 Правила исполнения функции
Место в программе для описания функции:
Описание функции должно находиться в программе обособленно, за
пределами любых других функций (т.е. не внутри какой-либо другой
193
функции, а снаружи).
Исполнение функции:
Вызванная для исполнения функция исполняется в соответствии с
кодом, составляющим тело функции.
7.9.3 Формат оператора return
Возвращаемое функцией значение - это значение параметра, указанного в скобках
оператора return. Оператор return состоит из ключевого слова return, Выражения,
обрамлённого круглыми скобками, и заканчивается знаком ; (точка с запятой).
Полноформатный оператор return:
return (Выражение ); // Оператор return
В качестве выражения в круглых скобках может быть указана константа, переменная или
вызов функции. Тип значения, возвращаемого с помощью оператора return, должен
совпадать с типом возвращаемого значения функции, указанным в заголовке. В случае
если этого совпадения нет, значение выражения, указанного в операторе return,
приводится к типу возвращаемого значения, указанному в заголовке описания функции. В
случае если такое преобразование невозможно, на этапе компиляции программы редактор
MetaEditor выдаст сообщение об ошибке.
7.9.4 Правило исполнения оператора return
Оператор return прекращает исполнение ближайшей внешней функции
и передаёт управление в вызывающую программу в соответствии с
правилами, определёнными для вызова функции. Значением,
возвращаемым функцией, является значение выражения, указанного в
операторе return. Если тип значения параметра, указанного в операторе
return, не совпадает с типом возвращаемого значения, указанным в
194
заголовке функции, то значение приводится к типу возвращаемого
значения, указанному в заголовке.
Пример использования оператора return, возвращающего значение:
bool My_function (int Alpha) // Описание пользовательской функции
{ // Начало тела функции
if(Alpha>0) // Оператор if
{ // Начало тела оператора if
Alert("Значение положительно"); // Вызов стандартной функции
return (true); // Первый выход из функции
} // Конец тела оператора if
return (false); // Второй выход из функции
} // Конец тела функции
В функциях с типом возвращаемого значения void необходимо использовать оператор
return без выражения:
return; // Оператор return без выражения
в круглых скобках
Пример использования оператора return без возврата значения:
void My_function (double Price_Sell)‘‘‘‘‘‘‘‘ // Описание пользовательской функции
‘‘{‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Начало тела функции
‘‘ if(Price_Sell-Ask >100 * Point)‘‘‘‘‘‘‘‘‘‘ // Оператор if
‘‘‘‘‘‘Alert("Прибыль по ордеру более 100 п");// Вызов стандартной функции
‘‘ return;‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘ // Выход из функции
‘‘}‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘‘// Конец тела функции
В описании функции допускается отсутствие оператора return. В этом случае функция
автоматически завершает работу, если (в соответствии с исполняемым алгоритмом) в теле
функции исполнился последний оператор. Пример описания функции, в которой не указан
оператор return:
void My_function (int Alpha) // Описание пользовательской функции
{ // Начало тела функции
for (int i=1; i<=Alpha; i++) // Оператор цикла
{ // Начало тела цикла
int a = 2*i + 3; // Оператор присваивания
Alert ("a=", a); // Оператор вызова станд. функции
} // Конец тела цикла
} // Конец тела функции
195
В данном случае функция завершит работу в момент окончания исполнения оператора
цикла for. Последним движением при исполнении функции будет проверка условия в
операторе цикла. Как только Условие в заголовке оператора цикла for станет ложным,
управление будет передано за пределы оператора цикла. Но в связи с тем, что оператор
цикла является последним исполняемым оператором в теле функции My_function (),
пользовательская функция завершит работу, а управление будет передано за пределы
функции, именно в то место, откуда функция была вызвана на исполнение.
196
8 Переменные
Для составления программ на любом алгоритмическом языке очень важно знать свойства
переменных различных типов и видов. В данном разделе рассматриваются все виды
переменных, используемых в MQL4.
8.1 Предопределённые переменные и функция RefreshRates
В языке MQL4 существуют переменные с предопределёнными именами.
Предопределённая переменная - это переменная с предопределённым названием, значение
которой определяется клиентским терминалом и не может быть изменено программным
способом. Предопределённые переменные отражают состояние текущего ценового
графика на момент запуска программы (эксперта, скрипта или пользовательского
индикатора) или в результате исполнения функции RefreshRates().
8.1.1 Перечень простых предопределённых имён переменных
Ask- последняя известная цена продажи по текущему финансовому инструменту;
Bid- последняя известная цена покупки по текущему финансовому инструменту;
Bars - количество баров на текущем графике;
Point - размер пункта текущего финансового инструмента в валюте котировки;
Digits - количество цифр после десятичной точки в цене текущего финансового
инструмента.
8.1.2 Перечень предопределённых имён массивов-таймсерий
Time - время открытия каждого бара текущего графика;
Open - цена открытия каждого бара текущего графика;
197
Close - цена закрытия каждого бара текущего графика;
High - максимальная цена каждого бара текущего графика;
Low - минимальная цена каждого бара текущего графика;
Volume - тиковый объем каждого бара текущего графика.
(понятия "массив" и "массив-таймсерия" рассматриваются в разделе Массивы).
8.1.3 Свойства предопределённых переменных
Название предопределённой переменной не может быть использовано для идентификации
пользовательской переменной. Предопределённые переменные могут использоваться в
выражениях наравне с другими переменными по тем же правилам, но изменить значение
предопределённой переменной нельзя. При попытке компилировать программу,
содержащую оператор присваивания, в котором слева от знака равенства указана
предопределённая переменная, редактор MetaEditor выдаст сообщение об ошибке. По
области видимости предопределённые переменные относятся к глобальным, т.е. доступны
из любой части программы (см. Виды переменных).
Наиболее важное свойство предопределённых переменных заключается в следующем:
Значения всех предопределённых переменных автоматически
обновляются клиентским терминалом в момент запуска на исполнение
специальных функций.
Предыдущее и текущее значения предопределённых переменных могут совпадать, но
само значение будет обновлённым. В момент запуска специальной функции значения этих
переменных уже обновлены и доступны с первых строк программы. Проиллюстрируем
обновление значений предопределённых переменных на следующем примере (эксперт
predefined.mq4 ):
//--------------------------------------------------------------------
// predefined.mq4
// Предназначен для использования в качестве примера в учебнике MQL4.
//--------------------------------------------------------------------
int start() // Спец. функция start
{
198
Alert("Bid = ", Bid); // Текущий курс
return; // Выход из start()
}
//--------------------------------------------------------------------
Запустив эту простую программу на выполнение легко убедиться, что значения
переменной Bid, отражаемые в сообщениях, всякий раз будут соответствовать значениям
текущего курса. Аналогичным способом можно проверить и значения других
переменных, зависящих от сложившихся условий. Например, переменная Ask также
прямо зависит от текущего курса. Значение переменной Bars тоже изменится, если
изменится количество баров. Это может произойти на том тике, на котором в окне
текущего финансового инструмента образуется новый бар. Значение Point зависит от
спецификации финансового инструмента. Например, для валютной пары EUR/USD это
значение равно 0.0001, а для валютной пары USD/JPY - равно 0.01. Значение Digits для
тех же валютных инструментов равно соответственно целым числам 4 и 2.
Другим важным свойством предопределённых переменных является следующее:
Клиентский терминал создаёт набор локальных копий
предопределённых переменных отдельно для каждой запущенной
программы. Каждая запущенная программа работают с собственным
набором копий исторических данных.
В одном клиентском терминале может быть одновременно запущено несколько
прикладных программ(экспертов, скриптов или индикаторов), и для каждой из них
клиентский терминал создаст свой набор копий значений всех предопределённых
переменных - исторических данных. Рассмотрим более подробно, чем вызвана такая
необходимость. На Рис. 52 показано, как будут работать эксперты, характеризующиеся
разной длительностью исполнения специальной функции start(). Для простоты положим,
что в рассматриваемых экспертах других специальных функций нет, и оба эксперта
работают в одинаковых таймфреймах одного и того же финансового инструмента.
199
Рис. 52. Время работы функции start() может быть больше или меньше интервала времени
между тиками.
Эксперты отличаются друг от друга временем исполнения специальной функции start().
Для обычных экспертов средней сложности это время составляет приблизительно от 1 до
100 миллисекунд. Другие эксперты могут исполняться значительно дольше, например,
несколько секунд или даже десятков секунд. Промежуток времени между тиками также
колеблется от миллисекунд до минут, а в редких случаях - нескольких десятков минут.
Проследим на представленном примере, как повлияет частота поступления тиков на
работу экспертов Эксперт 1 и Эксперт 2, имеющих различное время исполнения
специальной функции start().
В момент времени t 0 Эксперт 1 присоединяется к клиентскому терминалу и переходит в
режим ожидания тика. В момент t 1 поступает тик, в результате чего клиентский терминал
запускает на исполнение специальную функцию start(). Одновременно с этим событием
программа получает доступ к обновлённому набору копий значений предопределённых
переменных. В период исполнения программа может обращаться к этим значениям, они
будут оставаться неизменными в течение всего времени работы специальной функции
start(). По окончании исполнения специальной функции start() программа перейдёт в
режим ожидания нового тика.
Ближайшим событием, при котором предопределённые переменные могут получить
новые значения, является новый тик. Время исполнения Т1 специальной функции start()
Эксперта 1 значительно меньше, чем ожидаемое время между тиками, например,
промежуток времени t 1 - t 2 или t 2 - t 3 и т.д. В связи с этим в рассматриваемом периоде
исполнении Эксперта 1 не возникает ситуация, при которой значения предопределённых
переменных могли бы устареть, т.е. не соответствовать истинным (последним известным)
значениям на текущий момент.
200