MTK文件操作常用函数

时间:2020-12-01 09:56:01
 

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