标准I/O（一）

---

前言

      标准c库是应用层的一套函数库，标准I/O库就是标准c库当中用于文件I/O操作相关的一套库函数，使用标准I/O库需要包含头文件<stdio.h>。

一、标准I/O和文件I/O的区别

      1. 标准I/O是库函数,而文件I/O是系统调用。
      2. 标准I/O是对文件I/O的封装。
      3. 可移植性：标准I/O相比于文件I/O具有更好的可移植性。
      4. 效率更优：标准I/O在效率上高于文件I/O，这是因为标准I/O在应用层是带缓冲的（stdio缓冲区），而文件I/O在应用层是不带缓冲的，因此效率上标准I/O更优。

二、FILE指针和fopen()函数

    FILE指针：

      标准I/O使用FILE指针作为文件句柄，与文件I/O中的文件描述符相似。

    fopen()函数——打开文件

      标准I/O使用fopen函数打开文件:

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

      参数详解：
      path：指向文件路径，可以是绝对路径，也可以是相对路径。
      mode：指定了对该文件的读写权限，是一个字符串。

mode	说明	对应于open()函数的flags参数取值
r	以只读的方式打开文件	O_RDONLY
r+	以可读可写的方式打开文件	O_RDWR
w	以只写方式打开文件，如果参数path指定的文件存在，将文件长度截断为0；如果指定文件不存在则创建该文件	O_WRONLY | O_CREAT | O_TRUNC
w+	以可读、可写方式打开文件，如果参数path指定的文件存在，将文件长度截断为0；如果指定文件不存在则创建该文件	O_RDWR | O_CREAT | O_TRUNC
a	以只写方式打开文件，打开以进行追加内容（在文件末尾写入），如果文件不存在则创建该文件	O_WRONLY | O_CREAT | O_APPEND
a+	以可读、可写方式打开文件，以追加方式写入（在文件末尾写入），如果文件不存在则创建该文件	O_RDWR | O_CREAT | O_APPEND

      记忆要点：
      有带加号的就是以可读可写形式打开文件，r/r+没啥特殊功能，w/w+能将存在内容的文件长度截断为0（O_TRUNC），a记住append，在文件末尾写入。

      返回值：
      调用成功返回一个指向FILE类型对象的指针（FILE*），该指针与打开或创建的文件相关联，后续的标准I/O操作将围绕FILE指针进行。如果失败则返回NULL，并设置errno指示错误原因。

      新建文件的权限：
      fopen函数只有两个参数path和mode，没有参数去指定新建文件的权限，当参数mode取值为“w、w+、a、a+”时，如果指定的文件不存在将会创建文件，这时候新建的文件有一个默认权限，其权限是0666（八进制）。

    fclose()函数——关闭文件

      函数原型：

int fclose(FILE *stream);

三、读文件、写文件

    读文件——fread()函数

      函数原型：

size_t fread(void *ptr,size_t size,size_t nmemb,FILE*stream);

      参数详解：
      第一个参数指针ptr：指向缓冲区；
      第二个参数size：一个数据包/数据项的字节大小，而不是总共要读取的数据的字节大小；
      第三个参数nmemb：数据项的个数
      第四个参数stream：FILE指针，指向我们要读取的文件

      返回值：
      成功时返回读取到的数据项的数目（不是实际读取的字节数，除非size等于1）；如果发生错误或到达文件末尾，则fread()返回的值将小于参数nmemb，此时无法区分是到达了文件末尾还是发生错误，需要使用ferror()或feof()函数来判断。

    写文件——fwrite()函数

      函数原型：

size_t fwrite(const void * ptr,size_t size,size_t nmemb,FILE *stream);

      其参数与fread函数的大致相同，不再赘述。
      返回值：
      调用成功的时候返回写入的数据项的数目；如果发生错误，则返回的值将会小于参数nmemb（或等于0）
      需要注意的是，fread和fwrite发生错误的时候是不会设置errno值的，所以不用perror。

    设置读写位置——fseek()函数

      函数原型：

int fseek(FILE *stream,long offset,int whence);

      与lseek功能大致一样。
      参数详解：
      stream：FILE指针；offset：位置偏移量；whence：设置参考值（文件头部、文件尾部、当前指向的位置）
      返回值：
      成功时返回0，失败时返回-1，与lseek返回值不一样！lseek成功将返回从文件头部开始算起的位置偏移量（以字节为单位）。

    判断文件是否到达文件末尾——feof()函数

      函数原型：

int feof(FILE *stream);

      如果文件到达文件末尾，返回非零值（true），反之返回0（false）。

    判断是否发生错误——ferror()函数

      函数原型：

int ferror(FILE *stream);

      返回值：
      发生错误返回true，反之返回false。

    清除标志——clearerr()函数

      函数原型：

void clearerr(FILE *stream);

      作用：
      譬如在当文件读写指针到达文件末尾时，会设置标志位end-of-file，feof函数就是通过这个标志位来判断文件是否到达末尾的，如果这个标志位不进行清除的话，就可能对之后的判断造成误判，clearerr函数就是避免这种问题的发生。
      使用示例：

ret = fread(buf,1,11,f);
if(11>ret){
    if(ferror(f)){
            printf("fread error\n");
            fclose(f);    
            return 1;
    }
    else {
        if(feof(f)){
            printf("fread end-of-file\n");
            fclose(f);
            return 1;        
        }    
    }
    clearerr(f);
}