fopen , fread fwrite 函数读写二进制文件 问题总结

最近在解析 png 数据文件， 发现一个文件操作中容易忽略的问题，问题描述如下：

在使用 fread 读二进制文件（png 图片）的时候， 发现读取到内存中的数据和 二进制文件中的数据不一致， 同样， 在  使用 fwrite 写二进制文件（png 图片）的时候， 发现写入到内存中的数据和 二进制文件中的数据和内存中的数据也不一致。 

这个问题头疼了两天， 结果发现了一个很低级的错误。就是在读写二进制文件的时候，必须确保文件的打开形式是以 二进制读写的形式打开的，  即：文件的打开形式必须是 "rb", "wb" 要不然，读写数据的时候，就会出现错误。

/*
* 函数说明: 写二进制文件
* 参数描述: _fileName, 文件名称
*           _buf, 要写的内存缓冲。
*           _bufLen, 内存缓冲的长度
*   返回值: 0, 成功
*           -1, 失败
*
*/
int writeFile(const STR* _fileName, void* _buf, int _bufLen)
{
    FILE * fp = NULL;
    if( NULL == _buf || _bufLen <= 0 ) return (-1);

    fp = fopen(_fileName, "wb"); // 必须确保是以 二进制写入的形式打开

    if( NULL == fp )
    {
        return (-1);
    }

    fwrite(_buf, _bufLen, 1, fp); //二进制写

    fclose(fp);
    fp = NULL;

    return 0;    
}

/*
 * 函数说明:  读二进制文件

*  参数描述: _fileName, 文件名称
*             _buf, 读出来的数据存放位置
*             _bufLen, 数据的长度信息
*    返回值:  0, 成功
*             -1, 失败
*
*/
int readFile(const char* _fileName, void* _buf, int _bufLen)
{
    FILE* fp = NULL;
    if( NULL == _buf || _bufLen <= 0 ) return (-1);

    fp = fopen(_fileName, "rb"); // 必须确保是以 二进制读取的形式打开

    if( NULL == fp )
    {
        return (-1);
    }

    fread(_buf, _bufLen, 1, fp); // 二进制读

    fclose(fp);
    return 0;        
}


函数使用说明： 

FILE * fopen(const char * path,const char * mode);

参数path字符串包含欲打开的文件路径及文件名，
参数mode字符串则代表着流形态。mode有下列几种形态字符串: 
  r 打开只读文件，该文件必须存在。 
  r+ 打开可读写的文件，该文件必须存在。 
  rb+ 读写打开一个二进制文件，只允许读写数据。
  rt+ 读写打开一个文本文件，允许读和写。
  w 打开只写文件，若文件存在则文件长度清为0，即该文件内容会消失。若文件不存在则建立该文件。 
  w+ 打开可读写文件，若文件存在则文件长度清为零，即该文件内容会消失。若文件不存在则建立该文件。 
  a 以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。（EOF符保留） 
  a+ 以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 （原来的EOF符不保留）
  wb 只写打开或新建一个二进制文件；只允许写数据。
  wb+ 读写打开或建立一个二进制文件，允许读和写。
  wt+ 读写打开或着建立一个文本文件；允许读写。
  at+ 读写打开一个文本文件，允许读或在文本末追加数据。
  ab+ 读写打开一个二进制文件，允许读或在文件末追加数据。
  上述的形态字符串都可以再加一个b字符，如rb、w+b或ab＋等组合，加入b 字符用来告诉函数库打开的文件为二进制文件，而非纯文字文件。不过在POSIX系统，包含Linux都会忽略该字符。由fopen()所建立的新文件会具有S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP|S_IROTH|S_IWOTH(0666)权限，此文件权限也会参考umask 值。 
  有些C编译系统可能不完全提供所有这些功能，有的C版本不用"r+","w+","a+",而用"rw","wr","ar"等，读者注意所用系统的规定。
返回值
  文件顺利打开后，指向该流的文件指针就会被返回。若果文件打开失败则返回NULL，并把错误代码存在errno 中
附加说明
  一般而言，开文件后会作一些文件读取或写入的动作，若开文件失败，接下来的读写动作也无法顺利进行，所以在fopen()后请作错误判断及处理。

fread函数和fwrite函数
1.函数功能
  用来读写一个数据块。
2.一般调用形式
  fread(buffer,size,count,fp);
  fwrite(buffer,size,count,fp);
3.说明
  （1）buffer：是一个指针，对fread来说，它是读入数据的存放地址。对fwrite来说，是要输出数据的地址。
  （2）size：要读写的字节数；
  （3）count:要进行读写多少个size字节的数据项；
  （4）fp:文件型指针。