Язык программирования MQL4
Подождите немного. Документ загружается.
Исходные данные вводятся в программу с помощью внешних переменных типа string
(блок 1-2). В блоке 3-4 открыты и описаны переменные. Для удобства обработки в
программе введенные данные записываются (блок 4-5) в строковый массив Erray[][].
Каждое событие (сведения, характеризующие новость) представлено в двух элементах
массива по второму измерению. Размер первого измерения (количество строк в массиве)
определяется количеством новостей, в данном случае 5. Для того, чтобы при опробовании
эксперта на демо-счёте не вводить вручную все значения, можно загрузить файл настроек
эксперта example_news.set; файл настроек эксперта должен находиться в каталоге
Каталог_терминала\presets \.
В блоке 5-6 выполняется открытие файла. Если операция закончилась неудачей, то после
сообщения пользователю функция start() заканчивает работу. Если файл открыт удачно, то
управление передаётся оператору цикла for, в блок 6-7. Количество итераций в цикле
ограничивается количеством новостей, а именно, числом 5. В общем случае количество
вводимых значений, размер массива Erray и количество итераций можно увеличить до
желаемого.
На каждой итерации цикла выполняется проверка: не является ли какое либо из
введенных значений пустым. Для этого вычисляется длина строковых значений элементов
массива Erray. Если какое-то из них имеет нулевую длину, то это расценивается как
отсутствие текущего и следующих сообщений, поэтому текущая итерация прерывается.
До тех пор, пока не нашлось пустое значение элемента массива, выполняется запись
значений двух элементов массива в файл. Для записей значений в csv-файл используется
функция FileWrite():
9.3.6.8 Функция FileWrite()
int FileWrite(int handle, ...)
Функция предназначена для записи данных в файл CSV, разделитель между данными
включается автоматически. После записи в файл добавляется признак конца строки "\r\n".
При выводе числовые данные преобразуются в текстовый формат (см. функцию Print()).
Функция возвращает количество записанных символов или отрицательное значение, если
происходит ошибка.
Параметры:
handle - файловый описатель, возвращаемый функцией FileOpen();
... - данные, разделенные запятыми. Может быть не больше 63 параметров.
491
Данные типов double, int автоматически преобразовываются в строку (данные типов color,
datetime и bool воспринимаются как целые числа тип int, и тоже преобразовываются в
строку), данные типа string выводятся как есть, без преобразования. В качестве параметра
нельзя передать массивы; массивы должны выводиться поэлементно.
В рассматриваемом примере данные записываются в файл в строке:
Qnt_Symb=FileWrite(Handle,Erray[i,0],Erray[i,1]);//Запись в файл
При записи в файл после значения Erray[i,0] будет записан разделитель (символ,
используемый как разделитель, указывается в функции открытия файла FileOpen(), в
данном случае ';'). После окончания исполнения функции FileWrite(), т.е. в конце записи,
будет автоматически записан признак конца строки "\r\n". На всех последующих
итерациях цикла for будет сделана очередная запись такого же вида. Каждая новая запись
начинается с того места, где остался файловый указатель после последней записи. При
этом в файл будут записаны значения следующих элементов массива Erray (индексы
элементов на каждой итерации увеличиваются на 1).
Если текущая запись в файл выполнена успешно, то управление передаётся на
следующую итерацию. Если же запись в файл закончилась неудачей, то после сообщения
пользователю файл закрывается с помощью функции FileClose() и функция start()
заканчивает работу. Если все записи в файл выполнены успешно, то после окончания
исполнения цикла for управление передаётся функции закрытия файла FileClose() в блок
7-8. В этом случае выводится сообщение об успешном создании файла, после чего
исполнение функции start() заканчивается. По окончании исполнения эксперта будет
создан файл News.csv, представленный на Рис. 149.
9.3.6.9 Функции, применяемые для осуществления файловых операций
Функция Краткое описание
FileClose Закрытие файла, ранее открытого функцией FileOpen().
FileDelete Удаление указанного файла. Файлы могут быть удалены только в
том случае, если они расположены в папке каталог_терминала\
experts\files (каталог_терминала\tester\files в случае тестирования
492
эксперта) или ее подпапках.
FileFlush Сброс на диск всех данных, оставшихся в файловом буфере ввода-
вывода.
FileIsEnding Возвращает TRUE, если файловый указатель находится в конце
файла, иначе возвращает FALSE. В случае достижения конца
файла в процессе чтения функция GetLastError() вернет ошибку
ERR_END_OF_FILE (4099)
FileIsLineEndin
g
Возвращает TRUE, если файловый указатель находится в конце
строки файла формата CSV, иначе возвращает FALSE.
FileOpen Открывает Файл для ввода и/или вывода. Возвращает файловый
описатель открытого файла или -1 в случае неудачи.
FileOpenHistory Открывает файл в текущей папке истории (каталог_терминала\
history\server_name) или ее подпапках. Возвращает описатель
файла или -1 в случае неудачи.
FileReadArray Функция читает указанное число элементов из двоичного файла в
массив. Перед чтением данных массив должен быть достаточного
размера. Функция возвращает количество фактически прочитанных
элементов.
FileReadDouble Функция читает число двойной точности с плавающей точкой
(double) из текущей позиции бинарного файла. Размер числа может
быть 8 байтов (double) или 4 байта (float).
FileReadInteger Функция читает целое число из текущей позиции бинарного файла.
Размер целого числа может быть 1, 2 или 4 байта. Если размер
числа не указан, система пытается прочитать как 4-байтовое целое
число.
FileReadNumber Чтение числа с текущей позиции файла CSV до разделителя.
Применяется только для файлов CSV.
493
FileReadString Функция читает строку с текущей позиции файла. Применяется как
к CSV, так и к двоичным файлам. Для текстовых файлов строка
будет прочитана до разделителя. Для бинарных файлов в строку
будет прочитано указанное количество символов.
FileSeek Функция перемещает файловый указатель на новую позицию,
которая является смещением в байтах от начала, конца или
текущей позиции файла. Следующее чтение или запись происходят
с новой позиции. Если перемещение файлового указателя прошло
успешно, функция возвращает TRUE, иначе возвращает FALSE.
FileSize Функция возвращает размер файла в байтах.
FileTell Функция возвращает смещение текущей позицию файлового
указателя от начала файла.
FileWrite Функция предназначена для записи данных в файл CSV,
разделитель между данными включается автоматически. После
записи в файл добавляется признак конца строки "\r\n". При выводе
числовые данные преобразуются в текстовый формат. Возвращает
количество записанных символов или отрицательное значение,
если происходит ошибка.
FileWriteArray Функция записывает массив в бинарный файл.
FileWriteDouble Функция записывает число с плавающей запятой в двоичный файл.
FileWriteInteger Функция записывает значение целого числа в двоичный файл.
FileWriteString Функция записывает строку в двоичный файл с текущей позиции.
Возвращает число фактически записанных байтов или
отрицательное значение в случае ошибки.
Для получения подробного описания этих и других функций необходимо обратиться к
справочной документации на MQL4.community, сайте MetaQuotes Software Corp. или к
разделу "Справка" в редакторе MetaEditor
494
9.3.7 Массивы и таймсерии
При работе с массивами очень важно помнить, что в MQL4 нумерация любой
последовательности однотипных элементов начинается с нуля.
Ранее указывалось, что не следует путать максимальное значение индекса элемента
массива с количеством элементов этого массива (см. Массивы). Например, если объявлен
массив:
int Erray_OHL[3]; // Объявление массива
то это значит, что одномерный массив (имеющий одно измерение) с именем Erray_OHL
состоит из трёх элементов. Индексация элементов массива начинается с нуля, т.е. первый
из трёх элементов имеет индекс 0 (Erray_OHL[0]), второй элемент - индекс 1
(Erray_OHL[1 ]), а третий элемент - индекс 2 (Erray_OHL[2 ]). Таким образом,
максимальное значение индекса элемента массива на единицу меньше, чем количество
элементов в этом измерении. В данном случае массив является одномерным, т.е можно
говорить о количестве элементов в первом измерении: поскольку количество элементов в
массиве равно 3, значит максимальное значение индекса равно 2.
То же можно сказать и о нумерации измерений массива. Например, если объявлен массив:
int Erray_OHL[3][8]; // Объявление массива
то это значит, что массив имеет два измерения. Первое измерение этого массива
определяет количество строк (в данном примере 3), а второе измерение - количество
элементов в строке (или, что то же самое, количество столбцов, в данном примере 8).
Сами измерения также нумеруется. Первое измерение имеет номер 0, а второе измерение -
номер 1. Номера измерений используются, например, в функции ArrayRange().
9.3.7.1 Функция ArrayRange()
int ArrayRange(object array[], int range_index)
Функция возвращает число элементов в указанном измерении массива.
Использование функции ArrayRange() можно продемонстрировать при решении
следующей задачи:
495
Задача 38. Значения элементов матрицы 3х5 содержатся в массиве
Mas_1. Получить значения массива Mas_2, значения элементов в
котором равны значениям транспонированной матрицы. Использовать
произвольные значения элементов.
Зададимся некоторыми значениями элементов и представим исходную и искомую
матрицы, содержащиеся, соответственно, в массивах Mas_1 и Mas_2:
Индексы
0 1 2 3 4
0 1 2 3 4 5
1 11 12 13 14 15
2 21 22 23 24 25
Индексы 0 1 2
0 1 11 21
1 2 12 22
2 3 13 23
3 4 14 24
4 5 15 25
Исходная матрица, массив Mas_1.
Транспонированная матрица,
массив Mas_2.
Рис. 151. Исходная и транспонированная матрицы.
В данном случае вся задача сводится к тому, чтобы переписать значения одного массива в
другой, соблюдая при этом правила транспонирования матрицы, а именно, значения
элементов, содержащихся в столбцах исходного массива, переписать в строки искомого
массива. Решение задачи транспонирование матрицы реализовано в эксперте matrix.mq4:
//--------------------------------------------------------------------
// matrix.mq4
// Предназначен для использования в качестве примера в учебнике MQL4.
//--------------------------------------------------------------- 1 --
int start() // Спец. функция start
{
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
496
В функции 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().
497
Рис. 152. Результат работы эксперта matrix.mq4.
9.3.7.2 Функции для работы с массивами
Функция Краткое описание
ArrayBsearch Возвращает индекс первого найденного элемента в первом
измерении массива. Если элемент с указанным значением в
массиве отсутствует, функция вернет индекс ближайшего
элемента (по значению).
ArrayCopy Копирует один массив в другой. Массивы должны иметь
одинаковый тип. Массивы типа double[], int[], datetime[], color[], и
bool[], можно копировать как массивы одного типа. Возвращает
количество скопированных элементов.
ArrayCopyRates Копирует в двухмерный массив, вида RateInfo[][6], данные баров
текущего графика и возвращает количество скопированных баров,
либо -1 в случае неудачи.
ArrayCopySeries Копирует массив-таймсерию в пользовательский массив и
возвращает количество скопированных элементов.
ArrayDimension Возвращает ранг многомерного массива.
498
ArrayGetAsSerie
s
Возвращается TRUE, если массив организован как таймсерия
(элементы массива индексируются от последнего к первому),
иначе возвращается FALSE.
ArrayInitialize Устанавливает все элементы числового массива в одну величину.
Возвращает количество инициализированных элементов.
ArrayIsSeries Возвращается TRUE, если проверяемый массив является
массивом-таймсерией (Time[], Open[],Close[],High[],Low[] или
Volume[]), иначе возвращается FALSE.
ArrayMaximum Поиск элемента с максимальным значением. Функция возвращает
позицию максимального элемента в массиве.
ArrayMinimum Поиск элемента с минимальным значением. Функция возвращает
позицию минимального элемента в массиве.
ArrayRange Возвращает число элементов в указанном измерении массива.
Поскольку индексы начинаются с нуля, размер измерения на 1
больше, чем самый большой индекс.
ArrayResize Устанавливает новый размер в первом измерении массива. При
успешном выполнении функция возвращает количество всех
элементов, содержащихся в массиве после изменения размера, в
противном случае возвращает -1, и массив не меняет размеры.
ArraySetAsSeries Устанавливает направление индексирования в массиве.
ArraySize Возвращает количество элементов массива.
ArraySort Сортировка числовых массивов по первому измерению. Массивы-
таймсерии не могут быть отсортированы.
9.3.7.3 Функции доступа к таймсериям
499
Функци
я
Краткое описание
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 бара с
500