Ковалев Сергей. Программирование на алгоритмическом языке MQL4
Подождите немного. Документ загружается.
191
// Передаваемые параметры
отсутствуют
При вызове функции, имеющей умолчательные параметры, список передаваемых
параметров может быть ограничен (указан не полностью). Список параметров можно
ограничить, начиная с первого умолчательного параметра. В данном примере локальные
переменные b, c и d имеют умолчательные значения.
// Для функции с описанием:
int My_function (int a, bool b=true, int c=1, double d=0.5)
{
Операторы
}
// .. допустимы следующие вызовы:
My_function (Alf, Bet, Ham, Del) // Допустимый вызов функции
My_function (Alf ) // Допустимый вызов функции
My_function (3) // Допустимый вызов функции
My_function (Alf, 0) // Допустимый вызов функции
My_function (3, Tet) // Допустимый вызов функции
My_function (17, Bet, 3) // Допустимый вызов функции
My_function (17, Bet, 3, 0.5) // Допустимый вызов функции
Параметры, не имеющие значения по умолчанию, опускать нельзя. Если какой-либо из
умолчательных параметров опущен, то все последующие умолчательные параметры также
не указываются.
// Для функции с описанием:
int My_function (int a, bool b=true, int c=1, double d=0.5)
{
Операторы
}
// ..следующие вызовы являются
ошибочными:
My_function () // Недопустимый вызов функции:
неумолчательные..
// ..параметры опускать нельзя
(первый)
My_function (17, Bet, , 0.5) // Недопустимый вызов функции:
пропущен..
// ..умолчательный параметр
(третий)
192
Вызываемые функции делятся на две группы: возвращающие некоторое значение заранее
определённого типа и не возвращающие никакого значения.
7.8.2 Формат вызова функции, не возвращающей значение
Вызов функции, не возвращающей значение, может быть оформлен только в виде
отдельного оператора. Оператор вызова функции заканчивается знаком ; (точка с
запятой):
Название_функции (Список_параметров ); // Оператор вызова функции,не
возвращающей знач
Func_no_ret (Alfa, Betta, Gamma); // Пример оператора вызова функции,..
//.. не возвращающей значение
Иного формата (способа) для вызова функций, не возвращающих значение, не
предусмотрено.
7.8.3 Формат вызова функции, возвращающей значение
Вызов функции, возвращающей значение, может быть оформлен в виде отдельного
оператора, а также использоваться в коде программы - в том месте, где по смыслу
предполагается значение известного типа.
В случае оформления в виде отдельного оператора вызов функции заканчивается знаком ;
(точка с запятой):
Название_функции (Список_параметров ); // Оператор вызова функции,
возвращающей знач
Func_yes_ret (Alfa, Betta, Delta); // Пример оператора вызова функции,..
//.. возвращающей значение
7.8.4 Правила исполнения вызова функции
Вызов функции вызывает для исполнения одноимённую функцию. Если
вызов функции оформлен в виде отдельного оператора, то после
исполнения функции управление передаётся оператору, следующему за
вызовом функции. Если вызов функции используется в выражении, то
193
после исполнения функции управление передаётся в то место выражения,
где указан вызов функции, и дальнейшие вычисления в выражении
производятся со значением, возвращённым функцией.
Использование вызова функции в составе других операторов определяется форматом этих
операторов.
Задача 20. Составить программу, в которой реализуются следующие
условия: - если текущее время больше 15:00, то выполнить 10 итераций в
цикле for;- в остальных случаях выполнить 6 итераций.
Ниже приведен пример скрипта callfunction.mq4, в котором используются: вызов функции
в заголовке оператора for (в составе Выражения_1, согласно формату оператора for, см.
Оператор цикла for), вызов стандартной функции в виде отдельного оператора, в правой
части оператора присваивания (см. Оператор присваивания) и в заголовке оператора if-
else (в Условии, согласно формату оператора if-else, см. Условный оператор if-else).
///--------------------------------------------------------------------
// callfunction.mq4
// Предназначен для использования в качестве примера в учебнике MQL4.
//--------------------------------------------------------------------
int start() // Описание функции start()
{ // Начало тела ф-ии start()
int n; // Объявление переменной
int T=15; // Заданное время
for(int i=Func_yes_ret(T);i<=10;i++) // Использование функции в..
//.заголовке оператора цикла
{ // Начало тела цикла for
n=n+1; // Счётчик итераций
Alert ("Итерация n=",n," i=",i); // Оператор вызова функции
} // Конец тела цикла for
return; // Выход из функции start()
} // Конец тела ф-ии start()
//--------------------------------------------------------------------
int Func_yes_ret (int Times_in) // Описание пользоват. ф-ии
{ // Начало тела польз. ф-ии
datetime T_cur=TimeCurrent(); // Использование функции в..
// ..операторе присваивания
if(TimeHour(T_cur) > Times_in) // Использование функции в..
//..заголовке операт.if-else
return(1); // Возврат значения 1
194
return(5); // Возврат значения 5
} // Конец тела пользов. ф-ии
//--------------------------------------------------------------------
В приведенном примере использованы вызовы следующих функций с такими
передаваемыми параметрами:
в вызове функции Func_yes_ret(T) - переменная T;
в вызове функции Alert () - строковые константы "Итерация n=" и " i=", переменные n и i;
вызов функции TimeCurrent() не предусматривает передаваемых параметров;
в вызове функции TimeHour(T_cur) - переменная T_cur.
В программе реализован очень простой алгоритм. В переменной Т задаётся время в часах,
относительно которого производятся вычисления. В заголовке оператора for указан вызов
пользовательской функции Func_yes_ret(), которая может возвращать одно из двух
значений: 1 или 5. В зависимости от этого значения изменяется количество итераций в
цикле: либо их будет 10 (i изменяется от 1 до 10), либо 6 (i изменяется от 5 до 10). Для
наглядности в теле цикла используется счётчик итераций, каждое значение которого
выводится на экран с помощью функции Alert().
В описании пользовательской функции сначала вычисляется время в секундах,
прошедших после 00:00 1 января 1970 года (обращение к функции TimeCurrent()), а затем
текущее время в часах (обращение к функции TimeHour()). Разветвление алгоритма
осуществляется с помощью оператора if (вызов функции TimeHour() указан в его
условии). Если текущее время оказывается больше, чем переданное в пользовательскую
функцию (локальная переменная Times_in), то пользовательская функция возвращает 1,
иначе - возвращает 5.
Обратите внимание:
В программе нет описаний стандартных функций и вызова специальной
функции start().
Ниже показана функциональная схема скрипта callfunction.mq4:
195
Рис. 51. Функциональная схема программы, использующей обращение к функциям.
На функциональной схеме кружками обозначены вызовы функций (пользовательской и
стандартной). Красными стрелками показана передача управления в функцию и обратно.
Наглядно видно, что функция возвращает управление в то место, где указан вызов
функции, причём на пути между вызовом функции и самой функцией не совершается
каких-либо иных вычислений. В общем случае, если функция возвращает значение, это
значение передаётся в вызывающий модуль (по красной стрелке в направлении вызова
функции).
Специальные функции могут быть вызваны из любого места программы по общим
правилам, наравне с другими функциями. Специальные функции также могут иметь
параметры. Однако при вызове этих функций клиентским терминалом никакие параметры
извне переданы не будут, а будут использованы умолчательные значения. Использование
параметров в специальных функциях будет иметь смысл только при вызове их из
программы. Несмотря на то, что в языке MQL4 имеется техническая возможность вызова
специальных функций из программы, делать это не рекомендуется. Программу,
использующую обращение к специальным функциям, следует считать некорректной.
7.9 Описание функции и оператор return
По необходимости указания в программе можно выделить 2 группы функций: функции,
описания которых в программе не указываются, и функции, описания которых должны
196
быть указаны в программе. Описания стандартных функций в программе не указываются.
Описания пользовательских функций должны присутствовать в программе обязательно.
Описания специальных функций, если они используются, также указываются в
программе.
7.9.1 Формат описания функции
Описание функции состоит из двух основных частей - заголовка функции и тела функции.
Заголовок функции содержит указание типа возвращаемого значения, название функции и
список формальных параметров, обрамлённый круглыми скобками. Если функция не
должна возвращать никакого значения, то её тип обозначают void.
Тело функции может состоять из простых и/или составных операторов, обращений к
другим функциям и заключается в фигурные скобки.
Тип_возвращаемого_значения Название_функции (Список формальных
параметров)//Заголовок
{ // Открывающая фигурная скобка
Программный код, // Тело функции может состоять ..
составляющий тело //.. из операторов и ..
функции //.. обращений к другим функциям
} // Закрывающая фигурная скобка
Список параметров указывается через запятую. Количество параметров, передаваемых в
функцию, ограничено и не может превышать 64. В качестве формальных параметров в
заголовке функции могут быть указаны только переменные (но не константы, вызовы
других функций или выражения). Количество, тип и порядок упоминания передаваемых
параметров в вызове функции должны совпадать с количеством, типом и порядком
упоминания формальных параметров, указанных в описании функции (исключение
составляет вызов функции, имеющей параметры со значением по умолчанию):
int My_function (int a, double b) // Пример описания функции
{
int c = a * b + 3; // Оператор тела функции
return (c); // Оператор выхода из функции
}
// Здесь (слева направо в заголовке):
int // Тип возвращаемого значения
My_function // Название функции
int a // Первый формальный параметр а целого типа
197
double b // Второй формальный параметр b дествит.
типа
Параметры, передаваемые в функцию, могут иметь значения по умолчанию, которые
задаются константами соответствующего типа:
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 Правила исполнения функции
Место в программе для описания функции:
198
Описание функции должно находиться в программе обособленно, за
пределами любых других функций (т.е. не внутри какой-либо другой
функции, а снаружи).
Исполнение функции:
Вызванная для исполнения функция исполняется в соответствии с кодом,
составляющим тело функции.
7.9.3 Формат оператора return
Возвращаемое функцией значение - это значение параметра, указанного в скобках
оператора return. Оператор return состоит из ключевого слова return, Выражения,
обрамлённого круглыми скобками, и заканчивается знаком ; (точка с запятой).
Полноформатный оператор return:
return (Выражение ); // Оператор return
В качестве выражения в круглых скобках может быть указана константа, переменная или
вызов функции. Тип значения, возвращаемого с помощью оператора return, должен
совпадать с типом возвращаемого значения функции, указанным в заголовке. В случае
если этого совпадения нет, значение выражения, указанного в операторе return,
приводится к типу возвращаемого значения, указанному в заголовке описания функции. В
случае если такое преобразование невозможно, на этапе компиляции программы редактор
MetaEditor выдаст сообщение об ошибке.
7.9.4 Правило исполнения оператора return
Оператор return прекращает исполнение ближайшей внешней функции и
передаёт управление в вызывающую программу в соответствии с
правилами, определёнными для вызова функции. Значением,
199
возвращаемым функцией, является значение выражения, указанного в
операторе return. Если тип значения параметра, указанного в операторе
return, не совпадает с типом возвращаемого значения, указанным в
заголовке функции, то значение приводится к типу возвращаемого
значения, указанному в заголовке.
Пример использования оператора 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); // Оператор вызова станд. функции
200
} // Конец тела цикла
} // Конец тела функции
В данном случае функция завершит работу в момент окончания исполнения оператора
цикла for. Последним движением при исполнении функции будет проверка условия в
операторе цикла. Как только Условие в заголовке оператора цикла for станет ложным,
управление будет передано за пределы оператора цикла. Но в связи с тем, что оператор
цикла является последним исполняемым оператором в теле функции My_function (),
пользовательская функция завершит работу, а управление будет передано за пределы
функции, именно в то место, откуда функция была вызвана на исполнение.