MTK文件操作常用函数

1. int FS_Open(const WCHAR *FileName, UINT Flag)该函数用来打开一个文件，FielName为文件路径及文件名，Flag为文件的操作属性，其值可为 FS_READ_WRITE，FS_READ_ONLY，FS_OPEN_SHARED等。如果文件打开成功，该函数返回一个大于等于0的值，否则返回一个小于0 的值。具体操作方法可如下：FS_HANDLE h;if((h = (FS_HANDLE)FS_Open((constWCHAR *)filename, FS_READ_WRITE|FS_OPEN_SHARED|FS_CREATE)) >= 0){FS_Close(h);}注意，这里的路径要转换成Unicode字符串，可以通过AnsiiToUnicodeString(S8 * pOutBuffer, S8 * pInBuffer)函数来实现。比如我们在D盘的example 文件夹下有一个test.c文件需要对其进行修改（D:/example/test.c），则:FS_HANDLE h;S8 UnicodeName[100];AnsiiToUnicodeString((S8*) UnicodeName, (S8 *)” D://example//test.c”);if((h = (FS_HANDLE)FS_Open((const WCHAR *) UnicodeName, FS_READ_WRITE|FS_OPEN_SHARED|FS_CREATE)) >= 0){FS_Close(h);}也可使用FS_Open((const WCHAR *) L” D://example//test.c”,FS_READ_WRITE|FS_OPEN_SHARED|FS_CREATE)方式打开。当对文件修改完成后，要使用函数FS_Close()将其关闭。2. int FS_Close(FS_HANDLEFileHandle)用来关闭一个已经打开的文件。3. int FS_Read(FS_HANDLEFileHandle, void * DataPtr, UINT Length, UINT * Read)该函数用来将文件中的内容读取到一个DataPtr指向的缓冲区中，FileHandle为已打开文件的句柄，Length为要读取的字节数，参数*Read为实际读取到的字节数。在下面的例子中，我们将从前面打开的文件中读取100个字节(假设有)的数据到数组buf[]中：FS_HANDLE h;UINT read；S8 buf[256];S8UnicodeName[100];memset(buf, 0,sizeof(buf));AnsiiToUnicodeString((S8*) UnicodeName, (S8 *)” D://example//test.c”);if((h = (FS_HANDLE)FS_Open((const WCHAR *) UnicodeName, FS_READ_WRITE|FS_OPEN_SHARED|FS_CREATE)) >= 0){FS_Read(h, (void *)buf, 100, &read);FS_Close(h);}4. int FS_Write(FS_HANDLEFileHandle, void * DataPtr, UINT Length, UINT * Written)该函数用来将指针DataPtr指向的缓冲区数据写到文件中去，Length为要写入的数据的字节数，*Written值为实际写入的字节数，如下：UINT len， written；FS_Write(h, (void*)buf,len,&written);5. int FS_Commit(FS_HANDLEFileHandle)该函数用来将缓冲区中还没有写入到文件中的数据写入进文件中去，一般在FS_Write写完文件后用此函数来确保数据都被写进去。6. int FS_Seek(FS_HANDLE FileHandle,int Offset, int Whence)该函数用来将文件指针指向某个位置，Whence的取值有FS_FILE_BEGIN、FS_FILE_CURRENT和FS_FILE_END。比如可用如下方法将文件指向末尾部分,FS_Seek( h, 0,FS_FILE_END)；然后可在文件末尾追加写入数据。Offset为文件指针的偏移，例如FS_Seek(h,-5,FS_FILE_CURRENT)将文件指针向前移5个字节，如果是向后移5个字节的话则offset值为5。7. int FS_GetFileSize(FS_HANDLEFileHandle, UINT * Size)该函数返回文件的大小（即字节数）；8. int FS_Delete(const WCHAR *FileName)该函数用来删除一个文件。下面，我们用一个实例将以上几个函数联系起来使用。实例具体为：将一个文件中的内容（假定不多于5000个字节）全部读出来然后再追加到它自己的末尾，即将文件的内容copy一遍到它本身，如下：FS_HANDLE h;UINT read, written, size；static S8 buf[5000];S8 UnicodeName[100];memset(buf, 0, sizeof(buf));AnsiiToUnicodeString((S8 *) UnicodeName,(S8 *)” D://example//test.c”);if((h = (FS_HANDLE)FS_Open((constWCHAR *) UnicodeName, FS_READ_WRITE|FS_OPEN_SHARED|FS_CREATE)) >= 0){FS_GetFileSize(h,&size);if(size> 0){FS_Read(h, (void *)buf, size, &read);}FS_Seek(h, 0, FS_FILE_END);FS_Write(h, (void*)buf,size, &written);FS_Commit(h);FS_Close(h);}这里的FS_Read（FS_Write）在操作的时候一般会将指定大小的数据读（写）出来，但这并不能保证一定做的到，所以，比较合理的做法是读写完后判断size和read（written）的大小，如果read（written）小于size，则要将剩下的内容再继续读写。另外，由于系统分配给函数执行的栈空间不是足够大，所以，如果这里的buf比较大的话要声明成static，不然会栈越界的，而静态（static）型则不占用栈空间。