本组函数用于处理文件,是外汇程序化交易开发中常用的基础工具。
存放工作文件的三个目录(含子目录):
/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 相对应的子目录内。
文件在离线时同样可以打开,不必输入新数据就能将其制成图表。对于使用 TMGM外汇平台 进行程序化交易的用户,熟悉此函数有助于高效管理历史数据。
参数:
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 byte 的 double 型或者是 4 byte 的 float 型。
若需获取详细的错误信息,可调用 GetLastError() 函数。
参数:
handle - 用 FileOpen() 函数返回的句柄;size - 数值格式大小,DOUBLE_VALUE(8 bytes)或者 FLOAT_VALUE(4 bytes)。示例:
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 byte),SHORT_VALUE(2 bytes)或者 LONG_VALUE(4 bytes)。示例:
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; }