Ковалев Сергей. Программирование на алгоритмическом языке MQL4

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

861

{

int Mas_1[3][5]={1,2,3,4,5, 11,12,13,14,15, 21,22,23,24,25};

int Mas_2[5][3];

int R0= ArrayRange( Mas_1, 0); // Число элементов в первом изм

int R1= ArrayRange( Mas_1, 1); // Число элементов в втором изм

for(int i=0; i

В функции start() эксперта открыты два массива. Массив Mas_1 имеет 3 строки по 5

элементов в каждой строке, а массив Mas_2 - 5 строк по 3 элемента в строке. Собственно

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

Mas_2[[j][i] = Mas_1[i][j]; // Транспонирование матрицы

Для того чтобы определить условия выполнения (количество итераций) двух вложенных

операторов цикла, необходимо знать значения элементов в каждом из массивов. В данном

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

составления программ является некорректным. В общем случае программа может

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

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

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

местах все необходимые значения вычислялись. В данном случае, если необходимо будет

изменить размеры массивов, то исправления нужно внести только в строки, в которых эти

массивы открываются и инициализируются, и не придётся править код нигде в других

местах.

Для определения количества элементов в первом и втором измерении массива Mas_1

выполняются вычисления:

int R0 = ArrayRange( Mas_1, 0); // Число элементов в первом изм

int R1 = ArrayRange( Mas_1, 1); // Число элементов в втором изм

Обратите внимание, для первого измерения используется значение 0, а для второго 1.

Вычисленные значения переменных R0 и R1 используются для определения количества

итераций в циклах for.

Полученные значения элементов массива Mas_2 выводятся на экран с помощью функции

Comment().

862

Рис. 152. Результат работы эксперта matrix.mq4.

12.7.2 Функции для работы с массивами

Функция Краткое описание

ArrayBsearch Возвращает индекс первого найденного элемента в первом

измерении массива. Если элемент с указанным значением в

массиве отсутствует, функция вернет индекс ближайшего элемента

(по значению).

ArrayCopy Копирует один массив в другой. Массивы должны иметь

одинаковый тип. Массивы типа double[], int[], datetime[], color[], и

bool[], можно копировать как массивы одного типа. Возвращает

количество скопированных элементов.

ArrayCopyRates Копирует в двухмерный массив, вида RateInfo[][6], данные баров

текущего графика и возвращает количество скопированных баров,

либо -1 в случае неудачи.

ArrayCopySeries Копирует массив-таймсерию в пользовательский массив и

863

возвращает количество скопированных элементов.

ArrayDimension Возвращает ранг многомерного массива.

ArrayGetAsSeries

Возвращается TRUE, если массив организован как таймсерия

(элементы массива индексируются от последнего к первому), иначе

возвращается FALSE.

ArrayInitialize Устанавливает все элементы числового массива в одну величину.

Возвращает количество инициализированных элементов.

ArrayIsSeries Возвращается TRUE, если проверяемый массив является массивом-

таймсерией (Time[], Open[],Close[],High[],Low[] или Volume[]),

иначе возвращается FALSE.

ArrayMaximum Поиск элемента с максимальным значением. Функция возвращает

позицию максимального элемента в массиве.

ArrayMinimum Поиск элемента с минимальным значением. Функция возвращает

позицию минимального элемента в массиве.

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

Поскольку индексы начинаются с нуля, размер измерения на 1

больше, чем самый большой индекс.

ArrayResize Устанавливает новый размер в первом измерении массива. При

успешном выполнении функция возвращает количество всех

элементов, содержащихся в массиве после изменения размера, в

противном случае возвращает -1, и массив не меняет размеры.

ArraySetAsSeries

Устанавливает направление индексирования в массиве.

ArraySize Возвращает количество элементов массива.

864

ArraySort Сортировка числовых массивов по первому измерению. Массивы-

таймсерии не могут быть отсортированы.

12.7.3 Функции доступа к таймсериям

Функция

Краткое описание

iBars Возвращает количество баров на определенном графике.

iBarShift

Поиск бара по времени. Функция возвращает смещение бара, которому

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

отсутствует ("дыра" в истории), то функция возвращает, в зависимости от

параметра exact, -1 или смещение ближайшего бара.

iClose Возвращает значение цены закрытия указанного параметром shift бара с

соответствующего графика (symbol, timeframe). В случае ошибки функция

возвращает 0.

iHigh Возвращает значение максимальной цены указанного параметром shift бара

с соответствующего графика (symbol, timeframe). В случае ошибки функция

возвращает 0.

iHighest Возвращает индекс найденного наибольшего значения (смещение

относительно текущего бара).

iLow Возвращает значение минимальной цены указанного параметром shift бара

с соответствующего графика (symbol, timeframe). В случае ошибки функция

возвращает 0.

iLowest Возвращает индекс найденного наименьшего значения (смещение

865

относительно текущего бара).

iOpen Возвращает значение цены открытия указанного параметром shift бара с

соответствующего графика (symbol, timeframe). В случае ошибки функция

возвращает 0.

iTime Возвращает значение времени открытия указанного параметром shift бара с

соответствующего графика (symbol, timeframe). В случае ошибки функция

возвращает 0.

iVolume Возвращает значение тикового объема указанного параметром shift бара с

соответствующего графика (symbol, timeframe). В случае ошибки функция

возвращает 0.

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

справочной документации на MQL4.community, сайте MetaQuotes Software Corp. или к

разделу "Справка" в редакторе MetaEditor

12.8 Математические функции

В составе MQL4 имеются математические и тригонометрические функции.

Использование большинства из них не вызывает никаких затруднений. Например,

функция MathMax() возвращает максимальное из двух числовых значений, указанных в

списке параметров вызова функции. Использование других функций требует

определённой внимательности и вдумчивости. Рассмотрим одну из таких функций.

12.8.1 Функция MathFloor()

double MathFloor(double x)

Функция возвращает числовое значение, представляющее наибольшее целое число,

которое меньше или равно x.

Параметры:

866

x - числовое значение.

Обратите внимание, значение, возвращаемое функцией, является действительным числом

(типа double), в то же время в назначении функции указано, что функция возвращает

целое число. Это нужно понимать так, что функция возвращает действительное число, у

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

MathFloor() может вернуть 37.0 (положительное число типа double) или -4.0

(отрицательное число типа double).

В описании также указано, что функция возвращает максимальное из возможных чисел,

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

13.5, то максимальное действительное число, имеющее после разделительной только

нули, равно 13.0. Если же в вызове функции указано отрицательное число -13.5, то

максимальное меньшее целое число равно -14.0. Таким образом, изменение знака

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

не равны по модулю.

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

примера рассмотрим фрагмент расчёта количества лотов для новых ордеров:

int Percent =30; // % свободных средств

double Free =AccountFreeMargin(); // Свободные средства

double One_Lot=MarketInfo(Symb,MODE_MARGINREQUIRED);//Стоим. 1 лота

double Step =MarketInfo(Symb,MODE_LOTSTEP); // Шаг изменен размера

double Lots_New=MathFloor(Free*Percent/100/One_Lot/Step)*Step;

Значение переменной Percent задаётся пользователем. В данном случае пользователь

выделил для новых ордеров 30% свободных средств. В соответствии с правилами,

установленными дилинговым центром, правильно вычисленное количество лотов должно

быть кратно минимальному шагу изменения размера лотов (Step). Для расчёта

необходимы также значения свободных средств на счёте (Free) и стоимости одного лота

(One_Lot).

Рассмотрим логику рассуждений программиста, составившего формулу для расчёта

искомого количества лотов Lots_New для новых ордеров. Используем для наглядности

численные значения переменных. Пусть Free = 5000.0, One_Lot = 1360.0 (в большинстве

ДЦ стоимость 1 лота для валютной пары, в знаменателе которой USD, пропорциональна

867

цене по валютному инструменту), Step = 0.1. В этом случае программную строку для

вычисления Lots_New можно переписать так:

Lots_New = MathFloor(5000.0*30/100/1360.0/0.1)*0.1;

Значением выражения 5000.0*30/100 является количество средств, выделенных

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

может достигать 1500.0. Потратив все эти средства можно открыть один ордер,

количество лотов у которого равно 1500.0 / 1360.0 = 1.102941. Однако дилинговый центр

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

дилинговых центров) Step = 0.1. Для вычисления искомого количества лотов необходимо

отбросить "лишние" цифры в дробной части и заменить их нулями.

Для этого можно воспользоваться рассматриваемой математической функцией:

Lots_New = MathFloor(1.102941/0.1)*0.1;

Результатом вычисления MathFloor(1.102941/0.1) будет число 11.0, а вычисленным

значением переменной Lots_New - число 1.1 лота. Это значение соответствует правилам,

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

количество лотов для новых ордеров.

12.8.2 Математические функции

Функция Краткое описание

MathAbs Функция возвращает абсолютное значение (значение по модулю)

переданного ей числа.

MathArccos

Функция возвращает значение арккосинуса x в диапазоне 0 к π в

радианах. Если x меньше -1 или больше 1, функция возвращает NaN

(неопределенное значение)

MathArcsin

Функция возвращает арксинус x в диапазоне от -π/2 до π/2 радианов.

Если x-, меньше -1 или больше 1, функция возвращает NaN

868

(неопределенное значение).

MathArctan

Функция возвращает арктангенс x. Если x равен 0, функция возвращает

0. MathArctan возвращает значение в диапазоне от -π/2 до π/2 радианов.

MathCeil Функция возвращает числовое значение, представляющую наименьшее

целое число, которое больше или равно x.

MathCos Функция возвращает косинус угла.

MathExp Функция возвращает значение числа e в степени d. При переполнении

функция возвращает INF (бесконечность), в случае потери порядка

MathExp возвращает 0.

MathFloor Функция возвращает числовое значение, представляющее наибольшее

целое число, которое меньше или равно x.

MathLog Функции возвращают натуральный логарифм x в случае успеха. Если x

отрицателен, функция возвращает NaN (неопределенное значение). Если

x равен 0, функция возвращает INF (бесконечность).

MathMax Функция возвращает максимальное из двух числовых значений.

MathMin Функция возвращает минимальное из двух числовых значений.

MathMod Функция возвращает вещественный остаток от деления двух чисел.

Функция MathMod рассчитывает вещественный остаток f от x / y таким

образом, что x = i * y + f , где i является целым числом, f имеет тот же

знак, что и x, и абсолютное значение f меньше, чем абсолютное значение

MathPow Функция возвращает значение основания, возведенного в указанную

степень.

869

MathRand Функция возвращает псевдослучайное целое число в дипазоне от 0 до

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

функцию MathSrand, чтобы перевести генератор псевдослучайных чисел

в начальное состояние

MathRound

Функция возвращает значение, округленное до ближайшего целого

числа указанного числового значения.

MathSin Функция возвращает синус указанного угла.

MathSqrt Функция возвращает квадратный корень x. Если x отрицателен, MathSqrt

возвращает NaN (неопределенное значение).

MathSrand Функция устанавливает начальное состояние для генерации ряда

псевдослучайных целых чисел.

MathTan Функция возвращает тангенс x. Если x больше или равен 263 или меньше

или равен -263, то происходит потеря значения и функция возвращает

неопределенное число.

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

справочной документации на MQL4.community, сайте MetaQuotes Software Corp. или к

разделу "Справка" в редакторе MetaEditor

12.9 Глобальные переменные GlobalVariables

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

клиентского терминала, рассмотрена в разделе Переменные GlobalVariables. В

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

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

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

GV-переменных.

870

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

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

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

удалять GV-переменные, оставшиеся после предыдущего исполнения программы. Для

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

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

12.9.1 Функция GlobalVariablesDeleteAll()

int GlobalVariablesDeleteAll(string prefix_name=NULL)

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

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

которых начинаются на указанный префикс. Функция возвращает количество удаленных

переменных.

Параметры:

prefix_name - префикс имени удаляемых глобальных переменных.

Пример простого скрипта deleteall.mq4, удаляющего все без исключения глобальные

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

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

// deleteall.mq4

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

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

int start() // Специальная функция start()

{

GlobalVariablesDeleteAll(); // Удаление всех GV-переменных

PlaySound("W2.wav"); // Брыньк

return; // И уходим

}

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

Скрипт можно применять только в том случае, если в клиентском терминале нет ни одной

исполняющейся программы, использующей GV-переменные. В противном случае

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

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

переменных клиентского терминала (F3) будет пустым: