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)型则不占用栈空间。
转载:http://hi.baidu.com/steven926/blog/item/4beef50c0cdf0feb37d12277.html