MQL4文件操作函数(二)

本组函数用于处理文件。

存放工作文件的三个目录(含子目录):

• /HISTORY/<当前经纪商> – 特别提供的FileOpenHistory函数:
• /EXPERTS/FILES – 公用目录;
• /TESTER/FILES – 测试专用。

禁止访问来自于其他目录的工作文件。

• FileClose() – 关闭文件
• FileDelete() – 删除文件
• FileFlush() – 清除文件缓冲区并存盘
• FileIsEnding() – 判断文件指针是否到文件尾
• FileIsLineEnding() – 判断文件指针是否指向行尾
• FileOpen() – 打开文件
• FileOpenHistory() – 打开历史目录下文件
• FileReadArray() – 文件读取到数组
• FileReadDouble() – 从文件读取浮点型数据
• FileReadInteger() – 从文件读取整型数据
• FileReadNumber() – 从文本文件读取数值
• FileReadString() – 从文件读取字符串
• FileSeek() – 移动文件指针
• FileSize() – 获取文件大小
• FileTell() – 获取文件指针位置
• FileWrite() – 写入CSV文件
• FileWriteArray() – 数组内容写入文件
• FileWriteDouble() – 双精度数值写入文件
• FileWriteInteger() – 整型数值写入文件
• FileWriteString() – 字符串写入文件

FileOpenHistory() – 打开历史目录下文件

int FileOpenHistory(string filename, int mode, void delimiter)

在当前历史目录(terminal_directory/history/server_name)或子目录内打开文件。如果打开成功，返回文件句柄，如果函数失败，返回-1。如果想获取详细的错误信息，请调用GetLastError() 函数。

注：客户端有可能连接到不同经纪公司的服务器。每个经纪公司的历史数据(HST文件)会存储在terminal_ directory/history相对应的子目录内。

文件在离线时同样可以打开，不必输入新数据就能把它制成图表。

参数:

filename - 文件名称 mode - 打开模式。可以是以下的一种或是多种组合: FILE_BIN, FILE_CSV, FILE_READ, FILE_WRITE。 delimiter - csv 文件的限定符。默认为 ';' 符号。 

示例:

  int handle=FileOpenHistory("USDX240.HST",FILE_BIN|FILE_WRITE);  if(handle<1)    {     Print("不能创建 USDX240.HST文件");     return(false);    }  // 运行文件  // ...  FileClose(handle);

FileReadArray() – 文件读取到数组

int FileReadArray(int handle, void array[], int start, int count)

从二进制文件读取指定数量的内容到数组中。读取之前，确认数组要足够大。函数返回实际读取内容的数量。如果想获取详细的错误信息，请调用GetLastError() 函数。

参数:

handle - 用 FileOpen()函数返回的句柄。 array[] - 写入的数组。 start - 在数组中存储的开始位置。 count - 读取内容个数。 

示例:

  int handle;  double varray[10];  handle=FileOpen("filename.dat", FILE_BIN|FILE_READ);  if(handle>0)    {     FileReadArray(handle, varray, 0, 10);     FileClose(handle);    }

FileReadDouble() – 从文件读取浮点型数据

double FileReadDouble(int handle, void size)

从二进制文件当前位置读取浮点型双精度数据。数值格式长度可以是8byte的double型或者是4byte的float型。

如果想获取详细的错误信息，请调用GetLastError() 函数。

参数:

handle - 用 FileOpen()函数返回的句柄。  size - 数值格式大小，DOUBLE_VALUE(8 bytes) 或者 FLOAT_VALUE(4 bytes)。 

示例:

  int handle;  double value;  handle=FileOpen("mydata.dat",FILE_BIN);  if(handle>0)    {     value=FileReadDouble(handle,DOUBLE_VALUE);     FileClose(handle);    }

FileReadInteger() – 从文件读取整型数据

int FileReadInteger(int handle, void size)

从二进制文件当前位置读取整型数据。数值格式长度可以是1,2,4字节，如果格式大小不指定，系统设法读4字节的值。

如果想获取详细的错误信息，请调用GetLastError() 函数。

参数:

handle - 用 FileOpen()函数返回的句柄。  size - 数值格式大小，CHAR_VALUE(1 byte), SHORT_VALUE(2 bytes) 或者 LONG_VALUE(4 bytes)。 

示例:

  int handle;  int value;  handle=FileOpen("mydata.dat", FILE_BIN|FILE_READ);  if(handle>0)    {     value=FileReadInteger(h1,2);     FileClose(handle);    }

FileReadNumber() – 从文本文件读取数值

double FileReadNumber(int handle)

在文件当前位置读取分隔符之前的数值。只能为CSV文件。

如果想获取详细的错误信息，请调用GetLastError() 函数。

参数:

handle - 用 FileOpen()函数返回的句柄。

示例:

  int handle;  int value;  handle=FileOpen("filename.csv", FILE_CSV, ';');  if(handle>0)    {     value=FileReadNumber(handle);     FileClose(handle);    }

FileReadString() – 从文件读取字符串

string FileReadString(int handle, void length)

本函数从文件当前位置读取字符串，适用于CSV和二进制文件。对于文本文件，读取在分隔符之前字符串。对于二进制文件，将读取指定个数的字符串。

如果想获取详细的错误信息，请调用GetLastError() 函数。

参数:

handle - 用 FileOpen()函数返回的句柄。length - 要读取的字符串长度

示例:

  int handle;  string str;  handle=FileOpen("filename.csv", FILE_CSV|FILE_READ);  if(handle>0)    {     str=FileReadString(handle,100);     FileClose(handle);    }

FileSeek() – 移动文件指针

bool FileSeek(int handle, int offset, int origin)

本函数可以从文件头、文件尾或当前位置按字节移动文件指针到一个偏移的新位置。接下来读写操作就在一个新位置开始。

如果文件指针移动成功了，本函数返回TRUE，否则，返回FALSE。

如果想获取详细的错误信息，请调用GetLastError() 函数。

参数:

handle - 用 FileOpen()函数返回的句柄。 offset - 按字节数相对原点的偏移量。 origin - 初始位置。其值可以是以下任意常数:         SEEK_CUR - 当前位置,         SEEK_SET - 文件头         SEEK_END - 文件尾 

示例:

  int handle=FileOpen("filename.csv", FILE_CSV|FILE_READ|FILE_WRITE, ';');  if(handle>0)    {     FileSeek(handle, 0, SEEK_END);     //----在文件末端添加数据     FileWrite(handle, data1, data2);     FileClose(handle);     handle=0;    }