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

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

Программы MQL5

351

Draw_Triangles_Script.ex5 без указания пути, например, так:

//--- запрос ресурса скрипта в эксперте без указания пути

ObjectSetString(0,my_bitmap_name,OBJPROP_BMPFILE,0,"Draw_Triangles_Script.ex5::Files\\triangle.bmp");

то файл будет искаться в папке каталог_данных_терминала\MQL5\Experts\, если сам советник

находится в папке каталог_данных_терминала\MQL5\Experts\.

Смотри также

PlaySound(), ObjectSetInteger(), ChartApplyTemplate(), Файловые операции

Программы MQL5

352

Вызов импортируемых функций

Для импорта функций во время выполнения mql5-программы используется раннее связывание.

Это значит, что если в программе есть вызов импортируемой функции, то соответствующий

модуль (ex5 или dll) загружается в процессе загрузки программы. Библиотеки MQL5 и DLL

выполняются в потоке вызывающего модуля.

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

Drive:\Directory\FileName.Ext. Библиотеки MQL5 загружаются из папки terminal_dir\MQL5\Libraries

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

terminal_dir\experts.

Системные библиотеки (DLL) загружаются по правилам операционной системы. Если библиотека

уже загружена (например, другим экспертом и даже из другого клиентского терминала,

запущенного параллельно), то обращение идет к уже загруженной библиотеке. В противном

случае поиск идет в следующей последовательности:

1. Директория из которой был запущен модуль, импортирующий dll. Под модулем понимается

эксперт, скрипт, индикатор или библиотека EX5;

2. Директория каталог_данных_терминала\MQL5\Libraries (TERMINAL_DATA_PATH\MQL5

\Libraries);

3. Директория, из которой был запущен клиентский терминал MetaTrader 5;

4. Системная директория;

5. Директория Windows;

6. Текущая директория;

7. Директории, перечисленные в системной переменной PATH.

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

первая не сможет загрузиться.

Перед загрузкой эксперта (скрипта, индикатора) формируется общий список всех библиотечных

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

индикатора), так и из библиотек из этого списка. Таким образом обеспечивается однократная

загрузка многократно используемых библиотечных модулей EX5. Библиотеки пользуются

предопределенными переменными вызвавшего их эксперта (скрипта, индикатора).

Поиск импортируемой библиотеки EX5 производится в следующей последовательности:

1. Директория, путь к которой задается относительно директории импортирующего EX5 эксперта

(скрипта, индикатора);

2. Директория каталог_терминала\MQL5\Libraries;

3. Директория MQL5\Libraries в общей директории всех клиентских терминалов MetaTrader 5

(Common\MQL5\Libraries).

Функции, импортируемые из DLL в mql5-программу, должны обеспечивать соглашение о связях,

принятое для функций Windows API. Для обеспечения такого соглашения в исходном тексте

программ, написанных на языках C или C++ используется ключевое слово __stdcall, которое

является специфическим для компиляторов от фирмы Microsoft(r). Обсуждаемое соглашение о

связях характеризуется следующим:

вызывающая функция (в нашем случае mq5-программа) должна "видеть" прототип вызываемой

Программы MQL5

353

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

вызывающая функция (в нашем случае mql5-программа) складывает параметры на стек в

обратном порядке, справа налево - именно в таком порядке импортируемая функция считывает

переданные ей параметры;

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

(в нашем случае строк)

импортируемая функция, считывая переданные ей параметры, сама очищает стек.

При описании прототипа импортируемой функции можно использовать параметры со значениями

по умолчанию.

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

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

работу с соответствующим сообщением "expert stopped" в журнале. При этом эксперт не будет

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

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

эксперта и нажатия кнопки OK.

Передача параметров

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

передаются по ссылке. При передаче строки передается адрес буфера скопированной строки;

если строка передается по ссылке, то в функцию, импортируемую из DLL, передается адрес

буфера именно этой строки без копирования.

Структуры, содержащие динамические массивы, строки, классы, другие сложные структуры, а

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

в качестве параметра в импортируемую функцию.

При передаче в DLL массива всегда (независимо от флага AS_SERIES) передается адрес начала

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

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

дополнительный параметр.

Программы MQL5

354

Ошибки выполнения

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

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

mql5-программы предусмотрена предопределенная переменная _LastError.

Перед запуском функции OnInit переменная _LastError обнуляется. При возникновении ошибочной

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

принимает соответствующий код ошибки. Значение, сохраненное в этой переменной, можно

получить при помощи функции GetLastError().

Существует ряд критических ошибок, при возникновении которых выполнение программы

немедленно прерывается:

деление на ноль;

выход за пределы массива;

использование некорректного указателя объекта;

Предопределенные переменные

355

Предопределенные переменные

Для каждой выполняющейся mql5-программы поддерживается ряд предопределенных

переменных, которые отражают состояние текущего ценового графика на момент запуска

программы - эксперта, скрипта или пользовательского индикатора.

Значение предопределенным переменным устанавливает клиентский терминал перед запуском

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

изменены из mql5-программы. Исключение составляет переменная _LastError, которая может

быть обнулена функцией ResetLastError.

Переменная

Значение

_Digits

Количество десятичных знаков после запятой

_Point

Размер пункта текущего инструмента в

валюте котировки

_LastError

Значение последней ошибки

_Period

Значение таймфрейма текущего графика

_StopFlag

Флаг остановки программы

_Symbol

Имя символа текущего графика

_UninitReason

Код причины деинициализации программы

Библиотеки пользуются переменными вызвавшей их программы.

Предопределенные переменные

356

int _Digits

В переменной _Digits хранится количество десятичных знаков после запятой, определяющее

точность измерения цены символа текущего графика.

Можно также использовать функцию Digits().

Предопределенные переменные

357

double _Point

В переменной _Point хранится размер пункта текущего инструмента в валюте котировки.

Можно также использовать функцию Point().

Предопределенные переменные

358

int _LastError

В переменной _LastError хранится значение последней ошибки, произошедшей во время

исполнения mql5-программы. Сбросить значение в ноль можно функцией ResetLastError().

Для получения кода ошибки можно также использовать функцию GetLastError().

Предопределенные переменные

359

int _Period

В переменной _Period хранится значение таймфрейма текущего графика.

Можно также использовать функцию Period().

Смотри также

PeriodSeconds, Периоды графиков, Дата и время, Видимость объектов

Предопределенные переменные

360

bool _StopFlag

В переменной _StopFlag хранится флаг остановки mql5-программы. Когда клиентский терминал

пытается остановить программу, в эту переменную записывается значение true.

Для проверки значения флага _StopFlag можно также использовать функцию IsStopped().