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非已打开的文件。
注:关闭文件时,将缓冲区数据保存到文件中。