C文件函数总结

1、fopen（打开文件）

　　表头文件 #include<stdio.h>

　　定义函数 FILE *fopen(const char * path,const char * mode);

　　path：字符串包含欲打开的文件路径及文件名， mode：文件访问类型。
　　mode主要应用有:
　　r 　　   打开只读文件，该文件必须存在。
　　r+ 　　 打开可读写的文件，该文件必须存在。
　　w 　　  打开只写文件，若文件存在则文件长度清为0，即该文件内容会消失。若文件不存在则建立该文件。
　　w+ 　  打开可读写文件，若文件存在则文件长度清为零，即该文件内容会消失。若文件不存在则建立该文件。
　　a　　　 以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。
　　a+ 　　以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。

　　例： FILE *pFile = NULL;
 　　　　pFile = fopen("C:\\1234.txt", "w+");
 　　　　if (NULL == pFile)
 　　　　{
 　　　　　　 return -1;
 　　　　}
 　　　　fclose(pFile);

　　注：打开文件时，会将文件中内容保存到缓冲区中，对于一般函数而言，都是程序与缓冲区之间操作。

2、fprintf （按指定格式将数据输出到文件中）

　　表头文件：#include<stdio.h>

　　函数原型：int fprintf(FILE *stream, char *format[, argument,...]);

　　FILE* 一个FILE型的指针

　　char* 格式化参数

　　返回值：成功时返回转换的字节数，失败时返回一个负数　

　　fprintf(pFile,"%s\n",str);

3、fscanf　(按指定格式从文件中输入数据)　

　　表头文件：#include<stdio.h>　　

　　函数原型：int fscanf(FILE *stream, char *format[,argument...]);　　

　　FILE* 一个FILE型的指针　　

　　char* 格式化参数　　

　　返回值：成功时返回转换的字节数，失败时返回一个负数　　

　　fscanf(pFile,"%s",str);

　　需要注意的是：fscanf与fprintf如果在同一个范围内，需要使用fseek设置热点位置

4、fseek （移动文件焦点位置）

　　表头文件 #include<stdio.h>

　　定义函数 int fseek(FILE * stream,long offset,int whence);

　　函数说明 fseek()用来移动文件流的读写位置。参数stream为已打开的文件指针，参数offset为根据参数whence来移动读写位置的位移数。

　　参数 whence为下列其中一种:

　　SEEK_SET从距文件开头offset位移量为新的读写位置。SEEK_CUR 以目前的读写位置往后增加offset个位移量。

　　SEEK_END将读写位置指向文件尾后再增加offset个位移量。

　　当whence值为SEEK_CUR 或SEEK_END时，参数offset允许负值的出现。

　　下列是较特别的使用方式:
　　1) 欲将读写位置移动到文件开头时:fseek(FILE *stream,0,SEEK_SET);
　　2) 欲将读写位置移动到文件尾时:fseek(FILE *stream,0,0SEEK_END);

　　返回值 当调用成功时则返回0，若有错误则返回-1，errno会存放错误代码。

5、ftell （获取当前文件焦点位置）　　

　　表头文件 #include<stdio.h>

　　定义函数 long ftell(FILE * stream);

　　返回值：成功时则返回目前的读写位置，错误则返回-1，errno会存放错误代码。

　　文件关闭后，文件焦点位置为0。

6、fread（从文件流读取数据）

　　表头文件 #include<stdio.h>

　　定义函数 size_t fread(void * ptr,size_t size,size_t count,FILE * stream);

　　stream：为已打开的文件指针，ptr： 指向欲存放读取进来的数据空间，读取的字符数以参数count来决定。

　　Fread()会返回实际读取到的count数目，如果此值比参数count来得小，则代表可能读到了文件尾或有错误发生，这时必须用feof()或ferror()来决定发生什么情况。

     返回值 返回实际读取到的count数目。

　　注意：所有对文件内部操作的函数都会修改文件焦点。

7、fwrite （往文件流写入数据）

　　表头文件 #include<stdio.h>

　　定义函数 size_t fwrite(const void * ptr,size_t size,size_t count,FILE * stream);

　　stream：为已打开的文件指针，ptr ：指向欲写入的数据地址，size：一个元素的大小，count：元素个数

　　返回值 返回实际写入的item数目。

　　例： struct item str[5]; fwrite(str, sizeof(item),5,pFile);

　　注：count为item个数，不是指所占字节数

8、feof （检查文件流是否读到了文件尾）

　　定义函数 int feof(FILE * stream);

　　返回值 返回非零值代表已到达文件尾。

9、fgetc （由文件中读取一个字符）

　　函数原型 int fgetc(FILE * stream);

　　返回值 ：读取到的字符，若返回EOF则表示到了文件尾。

10、fgets（由文件中读取一字符串）

　　定义函数 char* fgets(char *s, int size, FILE * stream);

　　功能：从参数stream所指的文件内读入字符并存到参数s所指的内存空间，直到出现换行字符、读到文件尾或是已读了size-1个字符为止，最后会加上NULL作为字符串结束。

　　返回值 gets()若成功则返回s指针，返回NULL则表示有错误发生。

　　例： char szBuf[32] = {0};
 　　　　fgets(szBuf,32,pFile);

11、fputc （往文件中写入一个字符）

　　 原型：int fputc(int c, FILE* stream);

　　 返回值：写入成功则返回写入字符，失败返回EOF

12、fputs （往文件中写入一个字符串）

　　原型 int fputs(const char * s,FILE * stream);

　　 fputs()用来将参数s所指的字符串写入到参数stream所指的文件内。

　　返回值 若成功则返回写出的字符个数，返回EOF则表示有错误发生。

13、fclose （关闭文件）

　　原型 int fclose(FILE * stream);

　　fclose()用来关闭先前fopen()打开的文件，此动作会让缓冲区内的数据写入文件中，并释放系统所提供的文件资源。

　　返回值 若关文件动作成功则返回0，有错误发生时则返回EOF并把错误代码存到errno。

　　错误代码 EBADF表示参数stream非已打开的文件。

　　注：关闭文件时，将缓冲区数据保存到文件中。