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

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

Функци

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

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

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

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

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

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

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

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

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

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

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

функция возвращает 0.

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

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

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

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

функция возвращает 0.

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

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

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

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

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

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

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

функция возвращает 0.

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

841

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

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

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

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

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

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

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

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

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

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

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

12.8.1 Функция MathFloor()

double MathFloor(double x)

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

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

Параметры:

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

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

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

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

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

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

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

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

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

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

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

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

842

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

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

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

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

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, пропорциональна

цене по валютному инструменту), 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;

843

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

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

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

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

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

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

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

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

MathArcco

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

844

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

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

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

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

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

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

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

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

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

значение y.

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

степень.

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

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

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

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

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

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

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

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

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

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

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

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

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

возвращает неопределенное число.

845

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

12.9.1 Функция GlobalVariablesDeleteAll()

int GlobalVariablesDeleteAll(string prefix_name=NULL)

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

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

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

переменных.

Параметры:

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

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

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

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

// deleteall.mq4

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

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

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

846

{

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

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

return; // И уходим

}

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

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

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

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

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

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

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

скрипта deleteall.mq4.

12.9.2 Функции для работы с глобальными переменными

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

GlobalVariableCheck Возвращает значение TRUE, если GV-переменная

существует, иначе возвращает FALSE

GlobalVariableDel Удаляет глобальную переменную. При успешном

удалении функция возвращает TRUE, иначе FALSE.

GlobalVariableGet Возвращает значение существующей глобальной

переменной или 0 в случае ошибки.

847

GlobalVariableName Функция возвращает имя глобальной переменной по

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

переменных.

GlobalVariableSet Устанавливает новое значение глобальной

переменной. Если переменная не существует, то

система создает новую глобальную переменную. При

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

последнего доступа, иначе 0.

GlobalVariableSetOnConditio

Устанавливает новое значение существующей

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

переменной равно значению третьего параметра

check_value. Если переменной не существует, функция

сгенерирует ошибку

ERR_GLOBAL_VARIABLE_NOT_FOUND (4058) и

вернет FALSE. При успешном выполнении функция

возвращает TRUE, иначе FALSE.

GlobalVariablesDeleteAll Удаляет глобальные переменные. Если префикс для

имени не задан, то удаляются все глобальные

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

переменные, имена которых начинаются на указанный

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

переменных.

GlobalVariablesTotal Функция возвращает общее количество глобальных

переменных.

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

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

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

12.10 Пользовательские индикаторы

848

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

чтобы представить индикатор в удобном оформлении. Рассмотрим некоторые из них (см.

также Создание пользовательских индикаторов).

12.10.1 Функция SetIndexBuffer()

bool SetIndexBuffer(int index, double array[])

Функция связывает переменную-массив, объявленный на глобальном уровне, с

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

необходимых для расчета индикатора, задается с помощью функции IndicatorBuffers() и не

может быть больше 8. В случае успешного связывания возвращается TRUE, иначе FALSE.

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

GetLastError().

Параметры:

index - порядковый номер линии (допускаются значения от 0 до 7);

array[] - имя массива, связанного с расчетным буфером.

12.10.2 Функция SetIndexStyle()

void SetIndexStyle(int index, int type, int style=EMPTY, int width=EMPTY,

color clr=CLR_NONE)

Функция устанавливает новый тип, стиль, ширину и цвет для указанной линии

индикатора.

Параметры:

index - порядковый номер линии (допускаются значения от 0 до 7);

type - стиль отрисовки линии индикатора. Может быть одним из перечисленных стилей

отрисовки линии (см. Стили отображения индикаторных линий);

style - стиль линии. Используется для линий толщиной в 1 пиксель. Может быть одним из

стилей линии, указанных в приложении Стили отображения индикаторных линий. Пустое

значение (EMPTY) указывает, что стиль не будет изменен;

width - ширина линии; допустимые значения - 1,2,3,4,5; пустое значение (EMPTY)

указывает, что ширина не будет изменена;

clr - цвет линии. Пустое значение CLR_NONE указывает, что цвет не будет изменен.

849

12.10.3 Функция SetIndexLabel()

void SetIndexLabel(int index, string text)

Функция позволяет устанавливать имя линии индикатора для отображения информации в

окне DataWindow и всплывающей подсказке.

Параметры:

index - порядковый номер линии (допускаются значения от 0 до 7);

text - Текст описания линии индикатора. NULL означает, что значение этой линии не

показывается в DataWindow.

Пример простого индикатора, отображающего линию High (indicatorstyle.mq4),

использующий указанные выше функции:

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

// indicatorstyle.mq4

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

//--------------------------------------------------------------- 1 --

#property indicator_chart_window // Индик. рисуется в основном окне

#property indicator_buffers 1 // Количество буферов

#property indicator_color1 Blue // Цвет первой линии

double Buf_0[]; // Открытие индикаторного массива

//--------------------------------------------------------------- 2 --

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

{

SetIndexBuffer(0,Buf_0); // Назначение массива буферу

SetIndexStyle (0,DRAW_LINE,STYLE_SOLID,2);// Стиль линии

SetIndexLabel (0,"Линия High");

return; // Выход из спец. ф-ии init()

}

//--------------------------------------------------------------- 3 --

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

{

int i, // Индекс бара

Counted_bars; // Количество просчитанных баров

Counted_bars=IndicatorCounted(); // Количество просчитанных баров

i=Bars-Counted_bars-1; // Индекс первого непосчитанного

while(i>=0) // Цикл по непосчитанным барам

{

Buf_0[i]=High[i]; // Значение 0 буфера на i-ом баре

850