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

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

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

691

FileReadFloat

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

файла.

float FileReadFloat(

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

);

Параметры

file_handle

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

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

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

Примечание

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

Смотри также

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

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

692

FileReadInteger

Читает из бинарного файла значение типа int, short или char в зависимости от указанной длины в

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

int FileReadInteger(

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

int size=INT_VALUE // размер целого типа в байтах

);

Параметры

file_handle

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

size=INT_VALUE

[in] Количество байт (до 4 включительно), которые нужно записать. Предусмотрены

соответствующие константы: CHAR_VALUE=1, SHORT_VALUE=2 и INT_VALUE=4, таким образом

функция может прочитать целое значение типа char, short или int.

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

Значение типа int. Так как возвращается значение типа int, то его можно спокойно

преобразовать в любое целое, знаковое или беззнаковое, значение. Файловый указатель

перемещается на количество байт, считываемого целого типа.

Смотри также

IntegerToString, StringToInteger, Целые типы

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

693

FileReadLong

Читает целое число типа long (8 байт) из текущей позиции бинарного файла.

long FileReadLong(

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

);

Параметры

file_handle

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

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

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

Смотри также

Целые типы, FileReadInteger

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

694

FileReadNumber

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

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

double FileReadNumber(

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

);

Параметры

file_handle

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

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

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

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

695

FileReadString

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

string FileReadString(

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

int size=-1 // длина строки

);

Параметры

file_handle

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

size=-1

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

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

Прочитанная строка(string).

Примечание

При чтении из bin-файла обязательно указывать длину читаемой строки. При чтении из txt-

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

признака перевода строки "\r\n". При чтении из csv-файла длину строки также указывать не

надо, будет прочитана строка от текущего положения до ближайшего разделителя либо до

признака конца текстовой строки.

Если файл открыт с флагом FILE_ANSI, то прочитанная строка преобразовывается в Unicode.

Смотри также

Тип string, Преобразование данных

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

696

FileReadStruct

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

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

uint FileReadStruct(

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

any_simple_struct str_object, // структура, куда происходит считывание

int size=-1 // размер структуры в байтах

);

Параметры

file_handle

[in] Файловый описатель открытого бинарного файла.

str_object

[out] Объект указанной структуры. Структура не должна содержать строки, динамические

массивы и виртуальные функции.

size=-1

[in] Количество байт, которые нужно прочитать. Если размер не указан или указано большее

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

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

В случае удачи функция возвращает количество прочитанных байт. Файловый указатель

перемещается на это же количество байт.

Смотри также

Структуры и классы

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

697

FileSeek

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

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

void FileSeek(

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

long offset, // в байтах

ENUM_FILE_POSITION origin // позиция для отсчета

);

Параметры

file_handle

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

offset

[in] Смещение в байтах (может принимать и отрицательное значение).

origin

[in] Точка отсчета для смещения. Может принимать одно из значений перечисления

ENUM_FILE_POSITION.

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

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

Примечание

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

"левую границу" файла), то файловый указатель будет установлен на начало файла.

Если выставить позицию за "правую границу" файла (больше, чем размер файла), то

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

позиции. При этом между предыдущим концом файла и выставленной позицией будут записаны

неопределенные значения.

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

698

FileSize

Возвращает размер файла в байтах.

ulong FileSize(

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

);

Параметры

file_handle

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

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

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

Примечание

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

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

699

FileTell

Возвращает текущее положение файлового указателя соответствующего открытого файла.

ulong FileTell(

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

);

Параметры

file_handle

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

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

Текущая позиция файлового описателя в байтах от начала файла.

Примечание

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

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

700

FileWrite

Запись данных в файл типа CSV или TXT, разделитель между данными вставляется

автоматически, если он не равен 0. После записи в файл добавляется признак конца строки "\r\n".

uint FileWrite(

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

... // список записываемых параметров

);

Параметры

file_handle

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

...

[in] Список параметров, разделенных запятыми, для записи в файл. Количество выводимых в

файл параметров не должно превышать 63.

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

Количество записанных байт.

Примечание

При выводе числовые данные преобразуются в текстовый формат (см. функцию Print()). Данные

типа double выводятся с точностью до 16 десятичных цифр после точки, при этом данные могут

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

будет наиболее компактна. Данные типа float выводятся с 5 десятичными цифрами после точки.

Для вывода вещественных чисел с другой точностью либо в явно указанном формате

необходимо использовать функцию DoubleToString().

Числа типа bool выводятся в виде строк "true" или "false". Числа типа datetime выводятся в

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

Смотри также

Comment, Print, StringFormat