Справочник по языку программирования MQL5

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

Стандартные константы, перечисления и структуры

281

Константы числовых типов данных

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

оптимизировать работу mql5-программы при правильном применении. Для лучшей читаемости

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

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

Константа

Описание

Значение

CHAR_MIN

Минимальное значение,

которое может быть

представлено типом char

-128

CHAR_MAX

Максимальное значение,

которое может быть

представлено типом char

127

UCHAR_MAX

Максимальное значение,

которое может быть

представлено типом uchar

255

SHORT_MIN

Минимальное значение,

которое может быть

представлено типом short

-32768

SHORT_MAX

Максимальное значение,

которое может быть

представлено типом short

32767

USHORT_MAX

Максимальное значение,

которое может быть

представлено типом ushort

65535

INT_MIN

Минимальное значение,

которое может быть

представлено типом int

-2147483648

INT_MAX

Максимальное значение,

которое может быть

представлено типом int

2147483647

UINT_MAX

Максимальное значение,

которое может быть

представлено типом uint

4294967295

LONG_MIN

Минимальное значение,

которое может быть

представлено типом long

-9223372036854775808

LONG_MAX

Максимальное значение,

которое может быть

представлено типом long

9223372036854775807

ULONG_MAX

Максимальное значение,

которое может быть

представлено типом ulong

18446744073709551615

Стандартные константы, перечисления и структуры

282

DBL_MIN

Минимальное положительное

значение, которое может

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

double

2.2250738585072014e-308

DBL_MAX

Максимальное значение,

которое может быть

представлено типом double

1.7976931348623158e+308

DBL_EPSILON

Наименьшее число для

которого выполняется

условие 1.0+DBL_EPSILON !=

1.0

2.2204460492503131e-016

DBL_DIG

Количество значимых

десятичных знаков

DBL_MANT_DIG

Количество битов в мантиссе

DBL_MAX_10_EXP

Максимальное десятичное

значение степени экспоненты

308

DBL_MAX_EXP

Максимальное двоичное

значение степени экспоненты

1024

DBL_MIN_10_EXP

Минимальное десятичное

значение степени экспоненты

(-307)

DBL_MIN_EXP

Минимальное двоичное

значение степени экспоненты

(-1021)

FLT_MIN

Минимальное положительное

значение, которое может

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

float

1.175494351e-38

FLT_MAX

Максимальное значение,

которое может быть

представлено типом float

3.402823466e+38

FLT_EPSILON

Наименьшее число для

которого выполняется

условие 1.0+FLT_EPSILON !=

1.0

1.192092896e–07

FLT_DIG

Количество значимых

десятичных знаков

FLT_MANT_DIG

Количество битов в мантиссе

FLT_MAX_10_EXP

Максимальное десятичное

значение степени экспоненты

FLT_MAX_EXP

Максимальное двоичное

значение степени экспоненты

128

FLT_MIN_10_EXP

Минимальное десятичное

значение степени экспоненты

-37

Стандартные константы, перечисления и структуры

283

FLT_MIN_EXP

Минимальное двоичное

значение степени экспоненты

(-125)

Пример:

void OnStart()

{

//--- выведем значения констант

printf("CHAR_MIN = %d",CHAR_MIN);

printf("CHAR_MAX = %d",CHAR_MAX);

printf("UCHAR_MAX = %d",UCHAR_MAX);

printf("SHORT_MIN = %d",SHORT_MIN);

printf("SHORT_MAX = %d",SHORT_MAX);

printf("USHORT_MAX = %d",USHORT_MAX);

printf("INT_MIN = %d",INT_MIN);

printf("INT_MAX = %d",INT_MAX);

printf("UINT_MAX = %u",UINT_MAX);

printf("LONG_MIN = %I64d",LONG_MIN);

printf("LONG_MAX = %I64d",LONG_MAX);

printf("ULONG_MAX = %I64u",ULONG_MAX);

printf("EMPTY_VALUE = %.16e",EMPTY_VALUE);

printf("DBL_MIN = %.16e",DBL_MIN);

printf("DBL_MAX = %.16e",DBL_MAX);

printf("DBL_EPSILON = %.16e",DBL_EPSILON);

printf("DBL_DIG = %d",DBL_DIG);

printf("DBL_MANT_DIG = %d",DBL_MANT_DIG);

printf("DBL_MAX_10_EXP = %d",DBL_MAX_10_EXP);

printf("DBL_MAX_EXP = %d",DBL_MAX_EXP);

printf("DBL_MIN_10_EXP = %d",DBL_MIN_10_EXP);

printf("DBL_MIN_EXP = %d",DBL_MIN_EXP);

printf("FLT_MIN = %.8e",FLT_MIN);

printf("FLT_MAX = %.8e",FLT_MAX);

printf("FLT_EPSILON = %.8e",FLT_EPSILON);

}

Стандартные константы, перечисления и структуры

284

Причины деинициализации

Коды причины деинициализации эксперта, возвращаемые функцией UninitializeReason(). Могут

иметь любые из следующих значений:

Константа

Значение

Описание

REASON_PROGRAM

Эксперт прекратил свою

работу, вызвав функцию

ExpertRemove()

REASON_REMOVE

Программа удалена с

графика

REASON_RECOMPILE

Программа

перекомпилирована

REASON_CHARTCHANGE

Символ или период графика

был изменен

REASON_CHARTCLOSE

График закрыт

REASON_PARAMETERS

Входные параметры были

изменены пользователем

REASON_ACCOUNT

Активирован другой счет

REASON_TEMPLATE

Применен другой шаблон

графика

REASON_INITFAILED

Признак того, что обработчик

OnInit() вернул ненулевое

значение

REASON_CLOSE

Терминал был закрыт

Код причины деинициализации передается также в качестве параметра предопределенной

функции OnDeinit(const int reason).

Индикаторы принимают пока только код 1(REASON_REMOVE) и код 2(REASON_RECOMPILE).

Пример:

Стандартные константы, перечисления и структуры

285

input int par=7;

//+------------------------------------------------------------------+

//| get text description |

//+------------------------------------------------------------------+

string getUnitReasonText(int reasonCode)

{

string text="";

//---

switch(reasonCode)

{

case REASON_ACCOUNT:

text="Account was changed";break;

case REASON_CHARTCHANGE:

text="Symbol or timeframe was changed";break;

case REASON_CHARTCLOSE:

text="Chart was closed";break;

case REASON_PARAMETERS:

text="Input-parameter was changed";break;

case REASON_RECOMPILE:

text="Program "+__FILE__+" was recompiled";break;

case REASON_REMOVE:

text="Program "+__FILE__+" was removed from chart";break;

case REASON_TEMPLATE:

text="New template was applied to chart";break;

default:text="Another reason";

}

//---

return text;

}

//+------------------------------------------------------------------+

//| Expert deinitialization function |

//+------------------------------------------------------------------+

void OnDeinit(const int reason)

{

//--- Первый способ получить код причины деинициализации

Print(__FUNCTION__,"_Код причины деинициализации = ",reason);

//--- Второй способ получить код причины деинициализации

Print(__FUNCTION__,"_UninitReason = ",getUnitReasonText(_UninitReason));

}

Стандартные константы, перечисления и структуры

286

Проверка указателя объекта

Для проверки типа указателя объекта предназначена функция CheckPointer(), которая возвращает

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

исполнение программы будет немедленно прервано.

Объекты, созданные оператором new, имеют тип POINTER_DYNAMIC. Только для таких указателей

можно и нужно использовать оператор уничтожения delete().

Все остальные указатели имеют тип POINTER_AUTOMATIC, что означает, что данный объект был

создан автоматически средой исполнения mql5-программы. Такие объекты уничтожаются после

использования также автоматически.

ENUM_POINTER_TYPE

Константа

Описание

POINTER_INVALID

Некорректный указатель

POINTER_DYNAMIC

Указатель объекта, созданного оператором

new

POINTER_AUTOMATIC

Указатель любого объекта, созданного

автоматически (без использования new())

Смотри также

Ошибки выполнения, Оператор уничтожения объекта delete, CheckPointer()

Стандартные константы, перечисления и структуры

287

Прочие константы

Константа CLR_NONE служит для указания отсутствия цвета, то есть графическийобъект или

графическаясерия индикатора не будут отображены. Эта константа не вошла в список констант с

наименованиями Web-цветов, но может применяться везде, где требуется указание цвета.

Константа INVALID_HANDLE может использоваться при проверке файловых хэндлов (см. функции

FileOpen() и FileFindFirst()).

Константа

Описание

Значение

CHARTS_MAX

Максимально возможное

количество одновременно

открытых графиков в

терминале

100

CLR_NONE

Отсутствие цвета

-1

EMPTY_VALUE

Пустое значение в

индикаторном буфере

DBL_MAX

INVALID_HANDLE

Некорректный хэндл

-1

IS_DEBUG_MODE

Признак работы mq5-

программы в режиме

отладки

true в режиме отладки, в

противном случае false

NULL

Ноль любого типа

WHOLE_ARRAY

Означает количество

элементов, оставшееся до

конца массива, то есть,

будет обработан весь массив

-1

WRONG_VALUE

Константа может неявно

приводиться к типу любого

перечисления.

-1

Константа EMPTY_VALUE обычно соответствует тем значениям индикаторов, которые не

отрисовываются на графике. Например, для встроенного индикатора Standard Deviation с

периодом 20 не выводится на график линия для первых в истории 19 баров. Если создать хэндл

этого индикатора с помощью функции iStdDev() и скопировать в массив значения индикатора для

этих баров через CopyBuffer(), то эти значения как раз и будут равны EMPTY_VALUE.

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

индикатора, при котором не должна производиться отрисовка на графике. Для этого используйте

функция PlotIndexSetDouble() с модификатором PLOT_EMPTY_VALUE.

Константа NULL может быть присвоена переменной любого простого типа или указателю на объект

структуры или класса. Присвоение NULL строковой переменной означает полную деинициализацию

этой переменной.

Константа WRONG_VALUE предназначена для тех случаев, когда требуется вернуть значение

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

возвращаемое значение является значением этого перечисления. Приведем в качестве

Стандартные константы, перечисления и структуры

288

иллюстрации некую функцию CheckLineStyle(), которая возвращает стиль линии для объекта,

указанного по имени. Если при запросе стиля функцией ObjectGetInteger() результатом будет true,

то вернется значение перечисления ENUM_LINE_STYLE, иначе возвращается WRONG_VALUE.

void OnStart()

{

if(CheckLineStyle("MyChartObject")==WRONG_VALUE)

printf("Error line style getting.");

}

//+------------------------------------------------------------------+

//| возвращает стиль линии для объекта, указанного по имени |

//+------------------------------------------------------------------+

ENUM_LINE_STYLE CheckLineStyle(string name)

{

long style;

//---

if(ObjectGetInteger(0,name,OBJPROP_STYLE,0,style))

return((ENUM_LINE_STYLE)style);

else

return(WRONG_VALUE);

}

Константа WHOLE_ARRAY предназначена для функций, которые требуют указания количества

элементов в обрабатываемых массивах:

ArrayCopy();

ArrayMinimum();

ArrayMaximum();

FileReadArray();

FileWriteArray().

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

до конца, то достаточно указать значение WHOLE_ARRAY.

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

mql5-программы в режиме отладки. Например, в режиме отладки может потребоваться выводить

дополнительную отладочную информацию в лог терминала или создавать вспомогательные

графические объекты на графике.

Приведенный ниже пример создает объект Label и задает ее описание и цвет в зависимости от

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

MetaEditor, нажмите клавишу F5. Если запустить скрипта из окна навигатора в терминале, то цвет

и текст объекта Label будут другими.

Пример:

Стандартные константы, перечисления и структуры

289

//+------------------------------------------------------------------+

//| Check_DEBUG_MODE.mq5 |

//| http://www.metaquotes.net |

//+------------------------------------------------------------------+

#property link "http://www.metaquotes.net"

//+------------------------------------------------------------------+

//| Script program start function |

//+------------------------------------------------------------------+

void OnStart()

{

//---

string label_name="invisible_label";

if(ObjectFind(0,label_name)<0)

{

Print("Object ",label_name," not found. Error code = ",GetLastError());

//--- создадим объект Label

ObjectCreate(0,label_name,OBJ_LABEL,0,0,0);

//--- установим координату X

ObjectSetInteger(0,label_name,OBJPROP_XDISTANCE,200);

//--- установим координату Y

ObjectSetInteger(0,label_name,OBJPROP_YDISTANCE,300);

ResetLastError();

if(IS_DEBUG_MODE) // режим отладки

{

//--- выведем сообщение о режиме выполнения скрипта

ObjectSetString(0,label_name,OBJPROP_TEXT,"DEBUG MODE");

//--- зададим красный цвет текста

if(!ObjectSetInteger(0,label_name,OBJPROP_COLOR,clrRed))

Print("Не удалось установить цвет. Ошибка ",GetLastError());

}

else // рабочий режим

{

ObjectSetString(0,label_name,OBJPROP_TEXT,"RELEASE MODE");

//--- зададим невидимый цвет текста

if(!ObjectSetInteger(0,label_name,OBJPROP_COLOR,CLR_NONE))

Print("Не удалось установить цвет. Ошибка ",GetLastError());

}

ChartRedraw();

DebugBreak(); // здесь произойдет прерывание, если мы в режиме отладки

}

Смотри также

DebugBreak, Информация о запущенной MQL5-программе

Стандартные константы, перечисления и структуры

290

Структуры данных

В MQL5 существуют 8 предопределенных структур, предназначенные для хранения и передачи

служебной информации:

MqlDateTime предназначена для представления даты и времени;

MqlParam позволяет передавать входные параметры при создании хэндла индикатора с

помощью функции IndicatorCreate();

MqlRates предоставляет информацию об исторических данных, содержащих цену, объем и

спред;

MqlBookInfo для получения информации, отображаемой в стакане цен (окно котировок);

MqlTradeRequest для создания торгового запроса при проведении торговых операций;

MqlTradeCheckResult позволяет проверить подготовленный торговый запрос перед его

отправкой;

MqlTradeResult содержит ответ торгового сервера на торговый запрос, отправленный функцией

OrderSend();

MqlTick предназначена для быстрого получения наиболее востребованной информации о

текущих ценах.