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() – 字符串写入文件

FileClose() – 关闭文件

void FileClose(int handle)

关闭之前用FileOpen()函数打开的文件。

参数:

handle - FileOpen() 函数 返回的文件句柄

示例:

 int handle=FileOpen("filename", FILE_CSV|FILE_READ);  if(handle>0)    {     // 运行文件 ...     FileClose(handle);    }

FileDelete() – 删除文件

void FileDelete(string filename)

删除指定的文件。

如果想获取详细的错误信息，请调用 GetLastError() 函数。如果文件是在terminal_ dir/experts/files日录(在测试情况下，terminal_ directory/tester/files)或它的子目录，仅仅删除这个文件。

参数:

filename - 目录和文件名。

示例:

  // 将目录 terminal_dir/experts/files directory 下的 my_table.csv 文件删除  int lastError;  FileDelete("my_table.csv");  lastError=GetLastError();  if(laseError!=ERR_NOERROR)    {     Print("错误 (",lastError,") 删除文件my_table.csv");     return(0);    }

FileFlush() – 清除文件缓冲区并存盘

void FileFlush(int handle)

清除缓存中数据并存到磁盘上。

注: FileFlush()函数只能在文件读写操作中调用。

文件关闭时，数据将自动保存到磁盘，因此，在调用 FileClose() 函数之前没有必要调用 FileFlush() 函数。

参数:

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

示例:

  int bars_count=Bars;  int handle=FileOpen("mydat.csv",FILE_CSV|FILE_WRITE);  if(handle>0)    {     FileWrite(handle, "#","OPEN","CLOSE","HIGH","LOW");     for(int i=0;i<bars_count;i++)       FileWrite(handle, i+1,Open[i],Close[i],High[i], Low[i]);     FileFlush(handle);     ...     for(int i=0;i<bars_count;i++)       FileWrite(handle, i+1,Open[i],Close[i],High[i], Low[i]);     FileClose(handle);    }

FileIsEnding() – 判断文件指针是否到文件尾

bool FileIsEnding(int handle)

如果文件指针是在文件尾，返回true，否则，返回false。

如果想获取详细的错误信息，请调用 GetLastError() 函数。如果文件指针在只读期间到达文件尾，GetLastError() 函数将 返回错误 ERR_END_OF_FILE(4099)。

参数:

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

示例:

  if(FileIsEnding(h1))    {     FileClose(h1);     return(false);    }

FileIsLineEnding() – 判断文件指针是否指向行尾

bool FileIsLineEnding(int handle)

如果CSV文件指针指向行末，返回true，否则，返回false。

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

参数:

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

示例:

  if(FileIsLineEnding(h1))    {     FileClose(h1);     return(false);    }

FileOpen() – 打开文件

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

为输入或输出信息而打开文件。如果打开文件成功，返回句柄，否则，返回-1。如果想获取详细的错误信息，请调用 GetLastError() 函数。

注：文件只能在terminal_ directory/experts/files文件夹(智能交易测试在terminal_directory/tester/files目录)或子目录内被打开。

FILE_BIN 和 FILE_CSV 格式不能同时使用。

如果FILE_WRITE 与FILE_READ不组合使用，打开的文件长度为零。如果文件包含数据，它们能被删除。如果有必要向现存文件中添加数据，必须使用FILE_WRITE 与FILE_READ组合打开文件。

如果FILE_WRITE 与FILE_READ不组合使用，只能打开现存文件。如果文件不存在，可以使用 FILE_WRITE 模式创建。

在一个模块内最多能够同时打开32个文件。在同个模块内文件打开的句柄不能传递给其它模块(库)。

参数:

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

示例:

  int handle;  handle=FileOpen("my_data.csv",FILE_CSV|FILE_READ,';');  if(handle<1)    {     Print("未找到 my_data.dat 文件，错误", GetLastError());     return(false);    }