Ковалев Сергей. Программирование на алгоритмическом языке MQL4
Подождите немного. Документ загружается.
841
Файл может применяться как средство передачи данных в другую программу. В этом
случае файл может быть создан прикладной программой и использоваться ею как
приёмник информации. Например, при исполнении прикладной программы в файл может
быть записана торговая история по счёту. В дальнейшем этот файл может быть прочитан
другой программой, например, Excel, для построения диаграммы изменения баланса.
В других случаях требуется сообщить некоторую информацию прикладной программе,
например, расписание важных новостей. Исполняемая прикладная программа (например,
эксперт) может считать эту информацию из заранее подготовленного файла и учитывать
её в процессе вычислений для графического отображения на экране, сообщений
пользователю или при формировании торговых решений.
12.6.1 Имена и каталоги файлов
Название рабочего файла должно быть составлено в соответствии с правилами
операционной системы. Название любого файла, используемого в MQL4, состоит из двух
частей - имени файла и его расширения, разделённых точкой, например, News.txt.
Технически название файла никак не связано с содержащейся в нём информацией,
поэтому и имя файла и его расширение могут быть заданы программистом произвольно.
Имя файла обычно выбирается таким, чтобы оно отражало суть содержащихся в нём
данных.
Большинство программ автоматически запускаются на исполнение в компьютере
пользователя в случае, если по названию файла дважды кликнуть мышкой. В зависимости
от того, какое расширение имеется у файла, операционная среда подгрузит ту или иную
программу, в которой будет отражено содержание файла. Поэтому, выбирая расширение
рабочего файла, следует ориентироваться на то, какая программа (в случае
необходимости) обычно будет использоваться для просмотра файлов.
Наиболее распространёнными типами файлов (тип определяется расширением) являются
следующие:
- .txt - текстовый файл, для просмотра используется блокнот, Word, FrontPage и др.
редакторы;
- .csv - файл для построения таблиц в Excel;
842
- .htm - файл для просмотра в браузере, например, Internet Explorer, Netscape Navigator и
др.
Существует три каталога (с подкаталогами), в которых могут располагаться рабочие
файлы:
- Каталог_терминала\Experts \History\<текущий брокер>\ - для файлов истории;
- Каталог_терминала\Experts \Files\ - для общего случая;
- Каталог_терминала\Tester\ Files\ - для файлов, используемых при тестировании.
Рабочий файл может быть сохранён в одном из приведенных каталогов или их
подкаталогов. В случае, если в момент сохранения файла указанный подкаталог не
существует, то он будет создан клиентским терминалом автоматически. Работа с файлами,
содержащимися в других каталогах, не предусмотрена.
12.6.2 Режимы работы файлов
Технология взаимодействия прикладной программы с рабочим файлом предусматривает
несколько возможных режимов. В общем случае один файл может быть открыт
одновременно несколькими программами (в пределах одного компьютера или в
нескольких компьютерах, соединённых в сеть). При этом операционная среда
обеспечивает лишь для одной из таких программ полный доступ к файлу, а именно,
возможность чтения и записи в файл, а для всех остальных программ - доступ только для
чтения. Например, если файл My_text. doc уже открыт какой-то программой для чтения и
записи, то все другие программы перед открытием файла получат уведомление:
Рис. 146. Диалоговое окно, возникающее при попытке доступа к файлу, открытому другой
программой.
843
Использование указанной технологии гарантирует, что один файл не будет изменяться
одновременно двумя различными программами. Для того, чтобы исполняемая прикладная
программа могла взаимодействовать с рабочим файлом, его прежде всего необходимо
открыть. Режим открытия файла указывается в функции FileOpen().
Одна прикладная программа может открыть несколько рабочих файлов. Для того чтобы в
программе была возможность различать файлы между собой, каждому открытому файлу
ставится в соответствие файловый описатель.
Файловый описатель – уникальный номер файла, открытого исполняемой программой в
текущий момент.
При успешном открытии файла функция FileOpen () возвращает некоторое целое значение
(обычно это значение присваивается переменной handle), которое и является файловым
описателем. Большинство функций, предназначенных для работы с файлами,
предполагают использование значения файлового описателя в качестве одного из
формальных параметров.
12.6.3 Функция FileOpen()
int FileOpen(string filename, int mode, int delimiter=';')
Функция открывает файл для ввода и/или вывода. Функция возвращает файловый
описатель открытого файла или -1 в случае неудачи. Файлы могут открываться только в
каталоге Каталог_терминала\Experts \Files\ или в каталоге
Каталог_терминала\Tester\Files\ (в случае тестирования эксперта) или в их
подкаталогах.
Параметры:
filename - название файла;
mode - способ открытия файла; принимает значения (или их комбинацию): FILE_BIN,
FILE_CSV, FILE_READ, FILE_WRITE;
delimiter - знак разделителя для csv-файлов. По умолчанию применяется символ ';'.
Режим открытия файла FILE_READ предусматривает, что файл будет использоваться
программой только для чтения. Попытка открытия файла в этом режиме заканчивается
неудачей, если файла с указанным именем не существует.
844
Режим открытия файла FILE_WRITE предусматривает, что файл будет использоваться
программой только для записи. Попытка открытия файла в этом режиме приводит к
открытию файла нулевой длины. Даже если до открытия в файле были данные, то они
будут уничтожены. Открытие файла в этом режиме может закончиться неудачей, если
файл ранее был открыт другой программой (в режиме записи).
Допускается открытие файла в режиме FILE_READ|FILE_WRITE. Этот режим
предусматривает возможность чтения из файла и записи в файл. Режим используется при
необходимости дописать данные в файл, уже содержащий какие-то данные. Функция
предусматривает обязательное использование одного из режимов FILE_READ или
FILE_WRITE или их комбинацию.
Режим открытия FILE_BIN определяет работу с рабочим файлом, как с бинарным. Режим
открытия файла FILE_CSV определяет работу с рабочим файлом, как с текстовым.
Функция предусматривает обязательное использование одного из режимов FILE_BIN или
FILE_CSV. Одновременное использование режимов FILE_BIN и FILE_CSV не
допускается.
Функция предусматривает обязательное комбинирование режимов FILE_READ,
FILE_WRITE или FILE_READ|FILE_WRITE с режимами FILE_BIN или FILE_CSV.
Например, для чтения текстового файла необходимо использовать комбинацию режимов
FILE_CSV|FILE_READ, а для того, чтобы добавить запись в бинарный файл, нужно
использовать комбинацию FILE_BIN|FILE_READ|FILE_WRITE.
В пределах одного исполняемого модуля (прикладной программы, например, эксперта)
одновременно может быть открыто не более 32 файлов. Описатели файлов, открытых в
одном модуле, нельзя передавать в другие модули (библиотеки).
12.6.4 Содержание записей в файлах
При любой комбинации режимов записи данных заносятся в файл без промежутков. При
формировании файлов в режиме FILE_BIN записи данных заносятся подряд. В
зависимости от типа данных, записываемых в файл (и используемых для этого функций
записи), между группами записей может прописываться комбинация символов конца
строки ("\r\n"). При формировании файлов в режиме FILE_CSV записи данных
отделяются файловым разделителем (обычно ';'), а группы записей (составляющих строки)
разделяются с помощью комбинации символов конца строки ("\r\n").
845
Файловый разделитель - специальный символ; запись, которая заносится в файл для
разделения записей данных.
Файловый разделитель используется для разделения записей данных только в csv-файлах.
Общий принцип построения записей в любых файлах состоит в том, что записи заносятся
в фай в определённой последовательности, без промежутков. Собственно вся запись
представляет собой сплошную последовательность символов. Любой файл может быть
прочитан какой-либо программой, и (в зависимости от правил, реализованных в этой
программе) отображён на экране в том или ином виде. Например, пусть имеется файл
File_1.csv со следующим содержанием:
int FileOpen(string filename, int mode, int delimiter=';')
Файл File_1.csv будет по-разному отображён в различных текстовых редакторах:
Рис. 147. Отображение файла File_1 разными программами (File_1.csv).
В данном случае комбинация символов "\r\n" была воспринята каждой из программ (Excel
и Блокнот) как указание на порядок форматирования: последовательность данных после
комбинации "\r\n" отображается в новой строке, а само сочетание символов "\r\n" в окне
редактирования не отображается. В то же время, Excel - табличный редактор, поэтому
символ ";" был воспринят этой программой, как разделитель данных на столбцы.
Обратите внимание, символ ";" в окне Excel не отображается. Блокнот - текстовый
редактор. Правила, реализованные в этой программе, не предполагают деление на
столбцы, поэтому символ ";" был воспринят не как файловый разделитель, а как составная
часть данных, и поэтому отображён на экране.
Указанные символы (";" и "\r\n") используются для разделения записей в MQL4.
846
Рис. 148. Разновидности записей в рабочих файлах.
На Рис. 148 представлена структура записей данных в нескольких файлах. В верхней
строке показано содержание csv-файла, а в трёх нижних - структуры бинарных файлов.
Все эти файлы составлены в соответствии с правилами, соответствующими той или иной
функции записи в файл.
Запись в csv-файле - это последовательность строковых значений (типа string), между
которыми указываются либо файловый разделитель, либо признак конца строки. И то и
другое воспринимается при чтении данных (стандартной функцией MQL4 для чтения
файлов) как признак окончания содержательной части считываемого значения. Строковое
значение может быть разной длины, и заранее неизвестно, сколько именно символов
необходимо прочесть, поэтому считывание выполняется до момента обнаружения
программой одного из разделителей.
Записи в двух видах бинарных файлов представляют последовательность данных без
каких-либо разделителей. Такой порядок записи определяется фиксированной длиной для
данных разного типа: 4 байта для данных типа int, bool, datetime и color и 8 байт (или 4
байта, в зависимости от параметров функции записи) для данных типа double. В этом
случае нет необходимости в разделителях, т.к. считывание выполняется с помощью
стандартной функции для чтения данных определённого типа фиксированной длины.
Последний (нижний на Рис. 148) бинарный файл содержит данные типа string,
разделённые признаком конца строки.
Файловый указатель - место в файле, с которого начинается чтение следующего
значения.
847
Понятие "файловый указатель" является аналогом понятия "курсор". Файловый указатель
характеризуется позицией в файле. По мере прочтения данных файловый указатель
смещается вправо на одну или несколько позиций.
Задача 36. Прочесть из текстового файла данные о важных новостях и
отобразить на ценовом графике графические объекты (вертикальные
линии) в соответствии со временем публикации новостей.
Пусть в каталоге Каталог_терминала\Experts \Files\ имеется рабочий файл News.csv со
следующей записью:
Рис. 149. Содержание рабочего файла News.csv.
В данном случае в файле содержится информация о пяти событиях, которые должны
произойти в разных странах в разное время. Каждая строка содержит две записи. Первая
запись - строковое значение, несущее информацию о дате и времени события. Вторая
запись - текстовое описание события. Первые три символа во второй записи содержат
название валюты (страны), которой касается будущее событие.
Решение задачи состоит из двух частей. Сначала необходимо прочесть данные из рабочего
файла, а затем полученные значения использовать в качестве координат графических
объектов. Чтение данных из текстового файла осуществляется с помощью функции
FileReadString().
12.6.5 Функция FileReadString()
string FileReadString(int handle, int length=0)
Функция читает строку с текущей позиции файла. Применяется как к CSV, так и к
двоичным файлам. Для текстовых файлов строка будет прочитана до разделителя. Для
бинарных файлов в строке будет прочитано указанное количество символов. Чтобы
получить информацию об ошибке, необходимо вызвать функцию GetLastError().
848
Параметры:
handle - файловый описатель, возвращаемый функцией FileOpen();
length - количество символов для чтения.
Необходимость обработки данных о новостях обычно возникает один раз в начале торгов,
поэтому в данном случае, для решения Задачи 36, можно использовать скрипт. Скрипт
timetablenews.mq4 предназначен для считывания данных из файла и отображения
графических объектов в окне финансового инструмента.
//--------------------------------------------------------------------
// timetablenews.mq4
// Предназначен для использования в качестве примера в учебнике MQL4.
//--------------------------------------------------------------- 1 --
int start() // Спец. функция start
{
//--------------------------------------------------------------- 2 --
int Handle, // Файловый описатель
Stl; // Стиль вертикальной линии
string File_Name="News.csv", // Имя файла
Obj_Name, // Имя объекта
Instr, // Название валюты
One,Two, // 1я и 2я чать названия инстр.
Text, // Текст описания события
Str_DtTm; // Дата и время события(строка)
datetime Dat_DtTm; // Дата и время события(дата)
color Col; // Цвет вертикальной линии
//--------------------------------------------------------------- 3 --
Handle=FileOpen(File_Name,FILE_CSV|FILE_READ,";");// Открытие файла
if(Handle<0) // Неудача при открытии файла
{
if(GetLastError()==4103) // Если файла не существует,..
Alert("Нет файла с именем ",File_Name);//.. извещаем трейдера
else // При любой другой ошибке..
Alert("Ошибка при открытии файла ",File_Name);//..такое сообщ
PlaySound("Bzrrr.wav"); // Звуковое сопровождение
return; // Выход из start()
}
//--------------------------------------------------------------- 4 --
while(FileIsEnding(Handle)==false) // До тех пор, пока файловый ..
{ // ..указатель не в конце файла
//--------------------------------------------------------- 5 --
Str_DtTm =FileReadString(Handle);// Дата и время события(дата)
Text =FileReadString(Handle);// Текст описания события
if(FileIsEnding(Handle)==true) // Файловый указатель в конце
849
break; // Выход из чтения и рисования
//--------------------------------------------------------- 6 --
Dat_DtTm =StrToTime(Str_DtTm); // Преобразование типа данных
Instr =StringSubstr(Text,0,3);// Извлекаем первые 3 символа
One=StringSubstr(Symbol(),0,3);// Извлекаем первые 3 символа
Two=StringSubstr(Symbol(),3,3);// Извлекаем вторые 3 символа
Stl=STYLE_DOT; // Для всех - стиль пунктир
Col=DarkOrange; // Для всех - цвет такой
if(Instr==One || Instr==Two) // А для событий по нашему ..
{ // .. финансовому инструменту..
Stl=STYLE_SOLID; // .. такой стиль..
Col=Red; // .. и такой цвет верт. линии
}
//--------------------------------------------------------- 7 --
Obj_Name="News_Line "+Str_DtTm; // Имя объекта
ObjectCreate(Obj_Name,OBJ_VLINE,0,Dat_DtTm,0);//Создаем объект..
ObjectSet(Obj_Name,OBJPROP_COLOR, Col); // ..и его цвет,..
ObjectSet(Obj_Name,OBJPROP_STYLE, Stl); // ..стиль..
ObjectSetText(Obj_Name,Text,10); // ..и описание
}
//--------------------------------------------------------------- 8 --
FileClose( Handle ); // Закрываем файл
PlaySound("bulk.wav"); // Звуковое сопровождение
WindowRedraw(); // Перерисовываем объекты
return; // Выход из start()
}
//--------------------------------------------------------------- 9 --
В блоке 2-3 эксперта открыты и описаны используемые переменные. В блоке 3-4
осуществляется попытка открытия файла и производится анализ результатов этой
операции. Для открытия файла используется функция FileOpen():
Handle=FileOpen(File_Name,FILE_CSV|FILE_READ,";");// Открытие файла
Попытка открытия файла не всегда заканчивается успехом. Неудача может быть в том
случае, если файла с указанным именем не существует. При неудачной попытке открыть
файл (файловый описатель - отрицательное число) выводится необходимое сообщение
пользователю и исполнение функции start() заканчивается.
В случае успешного открытия файла управление передаётся оператору цикла while (блоки
4-8). На каждой итерации этого цикла выполняется чтение данных из файла (блок 5-6),
преобразование и анализ этих данных (блок 6-7) и создание графического объекта с
координатами и свойствами, соответствующими последним прочитанным данным (блок
7-8).
850
Выполнение цикла while происходит до тех пор, пока файловый указатель не
переместится в конец файла, т.е. когда справа от файлового указателя уже не останется
каких-либо данных. Для анализа положения файлового указателя используется функция
FileIsEnding().
12.6.6 Функция FileIsEnding()
bool FileIsEnding(int handle)
Функция возвращает TRUE, если файловый указатель находится в конце файла, иначе
возвращает FALSE. Чтобы получить информацию об ошибке, необходимо вызвать
функцию GetLastError(). В случае достижения конца файла в процессе чтения функция
GetLastError() вернет ошибку ERR_END_OF_FILE (4099).
Параметры:
handle - файловый описатель, возвращаемый функцией FileOpen().
Представленное решение (timetablenews.mq4) предусматривает, что в рабочем файле
News.csv может быть записано неопределённое количество новостей. В приведенном
примере (Рис. 149) файл News.csv содержит пять строк, соответствующих пяти событиям
(новостям). В общем случае количество строк может составлять от 0 до 20-30 в
зависимости от количества реальных событий, которые должны произойти в этот день.
Чтение записей из файла (идентифицируемого по значению переменной Handle)
осуществляется в блоке 5-6:
Str_DtTm =FileReadString(Handle);// Дата и время события(дата)
Text =FileReadString(Handle);// Текст описания события
if(FileIsEnding(Handle)==true) // Файловый указатель в конце
break; // Выход из чтения и рисования
В первой и второй строках блока 5-6 производится чтение данных из файла до
ближайшего разделителя. В третьей и четвёртой строках выполняется проверка: не
находится ли файловый указатель в конце файла. Если нет, то далее в цикле на основе
двух прочитанных значений создаются графические объекты. Если бы изначально было
точно известно количество записей, то анализ, выполняемый в третьей и четвёртой
строках был бы не нужен. В этом случае можно было бы жёстко задать количество
итераций в цикле (например, 5) и не выполнять лишнюю проверку.