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

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

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

681

FileCopy

Копирует исходный файл из локальной или общей папки в другой файл..

bool FileCopy(

string src_filename, // имя файла-источника

int common_flag, // место действия

string dst_filename, // имя файла назначения

int mode_flags // способ доступа

);

Параметры

src_filename

[in] Имя файла для копирования.

common_flag

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

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

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

dst_filename

[in] Имя результатного файла.

mode_flags

[in] Флаги доступа. Параметр может содержать только 2 флага: FILE_REWRITE и/или

FILE_COMMON - остальные флаги игнорируются. Если файл уже существует и при этом не был

указан флаг FILE_REWRITE, то файл не будет переписан, и функция возвратит false.

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

В случае неудачи функция возвращает false.

Примечание

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

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

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

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

флага FILE_REWRITE в значении параметра mode_flags.

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

682

FileDelete

Удаляет указанный файл в локальной папке клиентского терминала.

bool FileDelete(

string file_name // имя удаляемого файла

int common_flag=0 // местоположение удаляемого файла

);

Параметры

file_name

[in] Имя файла.

common_flag=0

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

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

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

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

В случае неудачи функция возвращает false.

Примечание

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

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

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

Удаляет указанный файл в локальной папке клиентского терминала (MQL5\files или MQL5

\tester\files в случае тестирования). Если же указан common_flag=FILE_COMMON, то функция

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

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

683

FileMove

Перемещает файл из локальной или общей папки в другую папку .

bool FileMove(

string src_filename, // имя файла для операции перемещения

int common_flag, // место действия

string dst_filename, // имя файла назначения

int mode_flags // способ доступа

);

Параметры

src_filename

[in] Имя файла для перемещения/переименования.

common_flag

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

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

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

dst_filename

[in] Имя результатного файла.

mode_flags

[in] Флаги доступа. Параметр может содержать только 2 флага: FILE_REWRITE и/или

FILE_COMMON - остальные флаги игнорируются. Если файл уже существует и при этом не был

указан флаг FILE_REWRITE, то файл не будет переписан, и функция возвратит false.

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

В случае неудачи функция возвращает false.

Примечание

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

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

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

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

флага FILE_REWRITE в значении параметра mode-flags.

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

684

FileFlush

Сброс на диск всех данных, оставшихся в файловом буфере ввода-вывода.

void FileFlush(

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

);

Параметры

file_handle

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

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

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

Примечание

Функцию FileFlush() необходимо вызывать между операциями чтения из файла и записи в файл.

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

685

FileIsEnding

Определяет конец файла в процессе чтения.

bool FileIsEnding(

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

);

Параметры

file_handle

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

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

Функция возвращает true в случае, если в процессе чтения или перемещения файлового

указателя достигнут конец файла.

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

686

FileIsLineEnding

Определяет конец строки в текстовом файле в процессе чтения.

bool FileIsLineEnding(

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

);

Параметры

file_handle

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

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

Возвращает true в случае, если в процессе чтения txt или csv-файла достигнут конец строки

(символы CR-LF).

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

687

FileReadArray

Читает массивы любых типов, кроме строковых (может быть массив структур, не содержащих

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

указателя.

uint FileReadArray(

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

void array[], // массив для записи

int start_item=0, // с какой позиции массива писать

int items_count=WHOLE_ARRAY // сколько читать

);

Параметры

file_handle

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

array[]

[out] Массив, куда данные будут загружены.

start_item=0

[in] Стартовая позиция для записи в массив.

items_count=WHOLE_ARRAY

[in] Количество элементов для чтения.

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

Количество прочитанных элементов. По умолчанию, читает весь массив (cnt=WHOLE_ARRAY).

Примечание

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

пытается увеличить размер массива.

Смотри также

Переменные

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

688

FileReadBool

Читает из файла типа CSV строку от текущего положения до разделителя (либо до конца

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

bool FileReadBool(

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

);

Параметры

file_handle

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

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

Прочитанная строка может иметь значения "true", "false" или символьное представление целых

чисел "0" или "1". Ненулевое значение преобразуется к логическому true. Функция возвращает

полученное преобразованное значение.

Смотри также

Тип bool

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

689

FileReadDatetime

Читает из файла типа CSV строку одного из форматов: "YYYY.MM.DD HH:MI:SS", "YYYY.MM.DD" или

"HH:MI:SS" - и преобразует её в значение типа datetime.

datetime FileReadDatetime(

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

);

Параметры

file_handle

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

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

Значение типа datetime.

Смотри также

Тип datetime, StringToTime, TimeToString

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

690

FileReadDouble

Читает число двойной точности с плавающей точкой (double) из бинарного файла с текущего

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

double FileReadDouble(

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

);

Параметры

file_handle

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

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

Значение типа double.

Примечание

Чтобы получить информацию об ошибке, необходимо вызвать функцию GetLastError().

Смотри также

Вещественные типы (double, float), StringToDouble, DoubleToString