c 函数fopen,fwrite,fread,fgets,fputs



函数fopen
函数功能：打开一个文件
函数原型：FILE * fopen(const char * path,const char * mode);
相关函数：open，fclose，fopen_s[1]，_wfopen
所需库：<stdio.h>
返回值：文件顺利打开后，指向该流的文件指针就会被返回。如果文件打开失败则返回NULL，并把错误代码存在errno 中。
一般而言，打开文件后会作一些文件读取或写入的动作，若打开文件失败，接下来的读写动作也无法顺利进行，所以一般在fopen()后作错误判断及处理。
参数说明：
参数path字符串包含欲打开的文件路径及文件名，参数mode字符串则代表着流形态。
mode有下列几种形态字符串:
r 以只读方式打开文件，该文件必须存在。
r+ 以可读写方式打开文件，该文件必须存在。
rb+ 读写打开一个二进制文件，允许读数据。
rw+ 读写打开一个文本文件，允许读和写。
w 打开只写文件，若文件存在则文件长度清为0，即该文件内容会消失。若文件不存在则建立该文件。
w+ 打开可读写文件，若文件存在则文件长度清为零，即该文件内容会消失。若文件不存在则建立该文件。
a 以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。（EOF符保留）
a+ 以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 （原来的EOF符不保留）
wb 只写打开或新建一个二进制文件；只允许写数据。
wb+ 读写打开或建立一个二进制文件，允许读和写。
ab+ 读写打开一个二进制文件，允许读或在文件末追加数据。
at+ 打开一个叫string的文件，a表示append,就是说写入处理的时候是接着原来文件已有内容写入，不是从头写入覆盖掉，t表示打开文件的类型是文本文件，+号表示对文件既可以读也可以写。
上述的形态字符串都可以再加一个b字符，如rb、w+b或ab+等组合，加入b 字符用来告诉函数库以二进制模式打开文件。如果不加b，表示默认加了t，即rt,wt,其中t表示以文本模式打开文件。由fopen()所建立的新文件会具有S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP|S_IROTH|S_IWOTH(0666)权限，此文件权限也会参考umask 值。
有些C编译系统可能不完全提供所有这些功能，有的C版本不用"r+","w+","a+",而用"rw","wr","ar"等，读者注意所用系统的规定。


C语言函数，向文件写入一个数据块
size_t fwrite(const void* buffer, size_t size, size_t count, FILE* stream);
注意：这个函数以二进制形式对文件进行操作，不局限于文本文件
返回值：返回实际写入的数据块数目
（1）buffer：是一个指针，对fwrite来说，是要输出数据的地址；
（2）size：要写入内容的单字节数；
（3）count:要进行写入size字节的数据项的个数；
（4）stream:目标文件指针；
（5）返回实际写入的数据项个数count。
说明：写入到文件的哪里？ 这个与文件的打开模式有关，如果是w+，则是从file pointer指向的地址开始写，替换掉之后的内容，文件的长度可以不变，stream的位置移动count个数；如果是a+，则从文件的末尾开始添加，文件长度加大。
fseek对此函数有作用，但是fwrite[1]函数写到用户空间缓冲区，并未同步到文件中，所以修改后要将内存与文件同步可以用fflush（FILE *fp）函数同步。




函数原型：
size_t fread(void* buffer,size_t size,size_t count,FILE* stream);
功 能：
从一个文件流中读数据,读取count个元素,每个元素size字节.如果调用成功返回count.返回实际读取size*count字节.如不成功，返回实际读取的元素个数
参 数：
buffer
用于接收数据的内存地址,大小至少是size*count字节.
size
单个元素的大小，单位是字节
count
元素的个数,每个元素是size字节.
stream
输入流
返回值：
实际读取的元素数.如果返回值与count(不是count*size)不相同,则可能文件结尾或发生错误.
从ferror和feof获取错误信息或检测是否到达文件结尾.




fgets函数
原型是char *fgets(char *buf, int bufsize, FILE *stream);
参数：
*buf: 字符型指针，指向将存储到的数据地址。
bufsize: 整型数据，指明buf指向的字符数组的大小。
*stream: 文件结构体指针，将要读取的文件流。
功能:
从文件结构体指针stream中读取数据，每次读取一行。读取的数据保存在buf指向的字符数组中，每次最多读取bufsize-1个字符（第bufsize个字符赋'\0'），如果文件中的该行，不足bufsize个字符，则读完该行就结束。如果函数读取成功，则返回指针buf，失败则返回NULL。
stream文件流指针体指向文件内容地址的偏移原则
如果使用fgets()读取某个文件，第一次读取的bufsize为5，而文件的第一行有10个字符（算上'\n'），那么读取文件的指针会偏移至当前读取完的这个字符之后的位置。也就是第二次再用fgets()读取文件的时候，则会继续读取其后的字符。而，如果使用fgets() 读取文件的时候bufsize大于该行的字符总数加2（多出来的两个，一个保存文件本身的'\n'换行，一个保存字符串本身的结束标识'\0'），文件并不会继续读下去，仅仅只是这一行读取完，随后指向文件的指针会自动偏移至下一行

判断文件是否存在

格式：int fgetc(FILE *stream);
意为从文件指针stream指向的文件中读取一个字符,读取一个字节后，光标位置后移一个字节。
这个函数的返回值，是返回所读取的一个字节。如果读到文件末尾或者读取出错时返回EOF。

FILE *pp;
char ch;
 if((pp=fopen(g_dest[n],"r"))==NULL)
 {
 WriteLog(__LINE__,"Error\n");
  }
 ch=fgetc(pp);
 if(ch==EOF)
 {
WriteLog(__LINE__,"file is null\n");
continue;
 } 

fputs
函数名: fputs
功 能:向指定的文件写入一个字符串（不自动写入字符串结束标记符‘\0’）。成功写入一个字符串后，文件的位置指针会自动后移，函数返回值为0；否则返回EOF(符号常量，其值为-1)。
用 法: int fputs(char *str, FILE *fp);
参数： str是字符型指针，可以是字符串常量，或者存放字符串的数组首地址。
fp是文件型指针，通过打开文件函数fopen()获得的。

if( fputs(tmpBuf,fpTmp) == EOF)
{
WriteLog(__LINE__,"fputs error!");
return -1;
}

组合 
char breakfile[100];
memset(breakfile,0,sizeof(breakfile));
 FILE *fp=NULL;
 fp = fopen("./breakfile.txt","r");
 fgets(breakfile, 102400, fp);
 fclose(fp);
 
 fp = fopen("breakfile.txt","w+");
 fwrite(breakfile,strlen(breakfile)+1,1,fp);
 fclose(fp);