IG学院

本组函数用于处理文件，在IG markets外汇平台的自动化交易中经常用到。

工作文件存放在以下三个目录（包含子目录）中：

/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(handle0) { FileReadArray(handle, varray, 0, 10); FileClose(handle); }FileReadDouble() – 从文件读取浮点型数据

double FileReadDouble(int handle, void size) 从二进制文件当前位置读取浮点型双精度数据。数值格式长度可以是8字节的double型或4字节的float型。

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

参数：

handle – 用FileOpen()函数返回的句柄；size – 数值格式大小，DOUBLE_VALUE（8字节）或FLOAT_VALUE（4字节）。示例：

int handle; double value; handle=FileOpen("mydata.dat",FILE_BIN); if(handle0) { 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字节）、SHORT_VALUE（2字节）或LONG_VALUE（4字节）。示例：

int handle; int value; handle=FileOpen("mydata.dat", FILE_BIN|FILE_READ); if(handle0) { 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(handle0) { 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(handle0) { 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(handle0) { FileSeek(handle, 0, SEEK_END); //----在文件末端添加数据 FileWrite(handle, data1, data2); FileClose(handle); handle=0; }