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

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

Файловые операции

671

FileReadArray

Читает массивы любых типов, кроме

строковых (может быть массив структур, не

содержащих строки и динамические

массивы), из бинарного файла с текущего

положения файлового указателя

FileReadBool

Читает из файла типа CSV строку от текущего

положения до разделителя (либо до конца

текстовой строки) и преобразует прочитанную

строку в значение типа bool

FileReadDatetime

Читает из файла типа CSV строку одного из

форматов: "YYYY.MM.DD HH:MI:SS", "YYYY.

MM.DD" или "HH:MI:SS" - и преобразует ее в

значение типа datetime

FileReadDouble

Читает число двойной точности с плавающей

точкой (double) из бинарного файла с

текущего положения файлового указателя

FileReadFloat

Читает из текущего положения файлового

указателя значение типа float

FileReadInteger

Читает из бинарного файла значение типа int,

short или char в зависимости от указанной

длины в байтах

FileReadLong

Читает из текущего положения файлового

указателя значение типа long

FileReadNumber

Читает из файла типа CSV строку от текущего

положения до разделителя (либо до конца

текстовой строки) и преобразует прочитанную

строку в значение типа double

FileReadString

Читает из файла строку с текущего

положения файлового указателя

FileReadStruct

Cчитывает из бинарного файла содержимое в

структуру, переданную в качестве параметра

FileSeek

Перемещает положение файлового указателя

на указанное количество байт относительно

указанного положения

FileSize

Возвращает размер соответствующего

открытого файла

FileTell

Возвращает текущее положение файлового

указателя соответствующего открытого файла

FileWrite

Записывает данные в файл типа CSV или TXT

FileWriteArray

Записывает в файл типа BIN массивы любых

типов, кроме строковых

FileWriteDouble

Записывает в двоичный файл значение

Файловые операции

672

параметра типа double с текущего положения

файлового указателя

FileWriteFloat

Записывает в двоичный файл значение

параметра типа float с текущего положения

файлового указателя

FileWriteInteger

Записывает в двоичный файл значение

параметра типа int с текущего положения

файлового указателя

FileWriteLong

Записывает в двоичный файл значение

параметра типа long с текущего положения

файлового указателя

FileWriteString

Записывает в файл типа BIN или TXT значение

параметра типа string с текущего положения

файлового указателя

FileWriteStruct

Записывает в двоичный файл содержимое

структуры, переданной в качестве параметра,

с текущего положения файлового указателя

FolderCreate

Создает директорию в папке Files (в

зависимости от значения common_flag)

FolderDelete

Удаляет указанную директорию. Если папка

не пуста, то она не может быть удалена

FolderClean

Удаляет все файлы в указанной папке

Если файл открывается для записи с помощью функции FileOpen(), то все указанные в пути

подпапки будут созданы в случае их отсутствия.

Файловые операции

673

FileFindFirst

Начинает перебор файлов в соответствующей директории в соответствии с указанным фильтром.

long FileFindFirst(

string file_filter, // строка - фильтр поиска

string& returned_filename, // имя найденного файла

int common_flag // определяет область поиска

);

Параметры

file_filter

[in] Фильтр поиска. В фильтре может быть указана поддиректория (или последовательность

вложенных поддиректорий) относительно директории \Files, в которой необходимо проводить

перебор файлов.

returned_filename

[out] Возвращаемый параметр, куда в случае удачи помещается имя первого найденного

файла.

common_flag

[in] Флаг, определяющий местоположение файла. Если common_flag=FILE_COMMON, то файл

находится в общей папке всех клиентских терминалов. В противном случае файл находится в

локальной папке.

Возвращаемое значение

Возвращает хэндл объекта поиска, который необходимо использовать для дальнейшего

перебора файлов функцией FileFindNext(), либо INVALID_HANDLE в случае, когда нет ни одного

файла, соответствующего фильтру (в частном случае – директория пуста). После окончания

поиска хэндл необходимо закрыть при помощи функции FileFindClose().

Примечание

Из соображений безопасности в языке MQL5 строго контролируется работа с файлами. Файлы, с

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

пределами файловой "песочницы".

Пример:

Файловые операции

674

void OnStart()

{

string filename;

//---

int found=FileFindFirst("*.*",filename);

if(found!=INVALID_HANDLE)

Print("FileFindFirst returned ",filename);

else

{

Print("Files not found!!! Continue search in Common");

found=FileFindFirst("*.*",filename,FILE_COMMON);

if(found!=INVALID_HANDLE)

Print("FileFindFirst in Common returned ",filename);

}

Смотри также

FileFindNext, FileFindClose

Файловые операции

675

FileFindNext

Продолжает поиск, начатый функцией FileFindFirst().

bool FileFindNext(

long search_handle, // handle поиска

string&  returned_filename // имя найденного файла

);

Параметры

search_handle

[in] Хэндл поиска, полученный функцией FileFindFirst().

returned_filename

[out] Имя следующего найденного файла или директории.

Возвращаемое значение

В случае удачи возвращает true, иначе false.

Пример:

void OnStart()

{

string filename;

int i=0;

//---

int search=FileFindFirst("*.*",filename);

if(search!=INVALID_HANDLE)

{

Print("FileFindFirst returned ",filename);

while(FileFindNext(search,filename))

{

i++;

Print(i,": ",filename);

}

FileFindClose(search);

}

else

Print("Files not found!!!");

}

Смотри также

FileFindFirst, FileFindClose

Файловые операции

676

FileFindClose

Закрывает хэндл поиска.

void FileFindClose(

long search_handle // handle поиска

);

Параметры

search_handle

[in] Хэндл поиска, полученный функцией FileFindFirst().

Возвращаемое значение

Нет возвращаемого значения.

Примечание

Функцию необходимо вызывать, чтобы освобождать системные ресурсы.

Файловые операции

677

FileIsExist

Проверяет существование файла.

bool FileIsExist(

string file_name, // имя файла

int common_flag=0 // зона поиска

);

Параметры

file_name

[in] Имя проверяемого файла.

common_flag=0

[in] Флаг, определяющий местоположение файла. Если common_flag=FILE_COMMON, то файл

находится в общей папке всех клиентских терминалов. В противном случае файл находится в

локальной папке.

Возвращаемое значение

Возвращает true, если указанный файл существует.

Примечание

Из соображений безопасности в языке MQL5 строго контролируется работа с файлами. Файлы, с

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

пределами файловой "песочницы".

Если common_flag=FILE_COMMON, то функция ищет указанный файл в общей папке всех

клиентских терминалов, в противном случае функция ищет файл в локальной папке (MQL5\Files

или MQL5\Tester\Files в случае тестирования).

Файловые операции

678

FileOpen

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

int FileOpen(

string file_name, // имя файла

int open_flags, // комбинация флагов

short delimiter='\t' // разделитель

uint codepage=CP_ACP // кодовая страница

);

Параметры

file_name

[in] Имя открываемого файла, может содержать подпапки. Если файл открывается для

записи, то указанные подпапки будут созданы в случае их отсутствия.

open_flags

[in] комбинация флагов, определяющая режим работы с файлом. Флаги определены

следующим образом:

FILE_READ файл открывается для чтения

FILE_WRITE файл открывается для записи

FILE_BIN двоичный режим чтения-записи (без преобразования из строки и в строку)

FILE_CSV файл типа csv (все записанные элементы преобразуются к строкам соответствующего

типа, unicode или ansi, и разделяются разделителем)

FILE_TXT простой текстовый файл (тот же csv, однако разделитель не принимается во

внимание)

FILE_ANSI строки типа ANSI (однобайтовые символы)

FILE_UNICODE строки типа UNICODE (двухбайтовые символы)

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

FILE_SHARE_WRITE совместный доступ по записи со стороны нескольких программ

FILE_COMMON расположение файла в общей папке всех клиентских терминалов

delimiter='\t'

[in] значение, используемое в качестве разделителя в txt или csv-файле. Если для csv-файла

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

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

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

codepage=CP_ACP

[in] Значение кодовой страницы. Для наиболее употребимых кодовых страниц предусмотрены

соответствующие константы.

Возвращаемое значение

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

для доступа к данным файла. В случае неудачи возвращает INVALID_HANDLE.

Примечание

Из соображений безопасности в языке MQL5 строго контролируется работа с файлами. Файлы, с

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

пределами файловой "песочницы".

Файловые операции

679

Файл открывается в папке клиентского терминала в подпапке MQL5\files (или

каталог_агента_тестирования\MQL5\files в случае тестирования). Если среди флагов указан

FILE_COMMON, то файл открывается в общей папке всех клиентских терминалов MetaTrader 5.

Пример:

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

//| Script program start function |

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

void OnStart()

{

//--- неправильный способ открытия файла

string terminal_data_path=TerminalInfoString(TERMINAL_DATA_PATH);

string filename=terminal_data_path+"\\MQL5\\Files\\"+"fractals.csv";

int filehandle=FileOpen(filename,FILE_WRITE|FILE_CSV);

if(filehandle<0)

{

Print("Неудачная попытка открыть файл по абсолютному пути");

Print("Код ошибки ",GetLastError());

}

//--- правильный способ работы в "файловой песочнице"

ResetLastError();

filehandle=FileOpen("fractals.csv",FILE_WRITE|FILE_CSV);

if(filehandle!=INVALID_HANDLE)

{

FileWrite(filehandle,TimeCurrent(),Symbol(),PERIOD_CURRENT);

FileClose(filehandle);

Print("FileOpen OK");

}

else Print("Операция FileOpen неудачна, ошибка ",GetLastError());

//--- еще один пример с созданием вложенной директории в MQL5\Files\

string subfolder="Research";

filehandle=FileOpen(subfolder+"\\fractals.txt",FILE_WRITE|FILE_CSV);

if(filehandle!=INVALID_HANDLE)

{

FileWrite(filehandle,TimeCurrent(),Symbol(),PERIOD_CURRENT);

FileClose(filehandle);

Print("Файл должен быть создан в папке "+terminal_data_path+"\\"+subfolder);

}

else Print("File open failed, error ",GetLastError());

}

Смотри также

Использование кодовой страницы, FileFindFirst, FolderCreate, Флаги открытия файлов

Файловые операции

680

FileClose

Закрытие файла, ранее открытого функцией FileOpen() .

void FileClose(

int file_handle // handle файла

);

Параметры

file_handle

[in] Файловый описатель, возвращаемый функцией FileOpen().

Возвращаемое значение

Нет возвращаемого значения.