C_2019_5_8(文件操作相关的函数)

只要我认真的活过，无愧的付出过。
人们将无权耻笑我是入不敷出的傻瓜， 也不必用他的尺度来衡量我值得或是不值得！

1. 打开与关闭文件

1.1 fopen 函数说明

1.1.1 作用

用来打开一个文件

1.1.2 格式

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

1.1.3 返回值

打开文件成功返回一个文件指针，若打开文件失败则返回NULL

1.1.4 参数说明

*path：字符串包含欲打开的文件路径及文件名(例如：D:\A.txt)，注意在C语言中欲输出一个"“则需要输两个”\"

*mode：代表着流形态，mode有下列几种形态字符串

        r      打开只读文件，该文件必须存在。

        r+    打开可读写的文件，该文件必须存在。

        rb+  读写打开一个二进制文件，只允许读写数据。

        rt+   读写打开一个文本文件，允许读和写。

        w      打开只写文件，若文件存在则文件长度清为0，即该文件内容会消失。若文件不存在则建立该文件。  

        w+    打开可读写文件，若文件存在则文件长度清为零，即该文件内容会消失。若文件不存在则建立该文件。

        a       以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。（EOF符保留）

        a+     以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。（原来的EOF符不保留）

        wb    只写打开或新建一个二进制文件；只允许写数据。

        wb+  读写打开或建立一个二进制文件，允许读和写。  

        wt+   读写打开或着建立一个文本文件；允许读写。  

        at+    读写打开一个文本文件，允许读或在文本末追加数据。  

        ab+   读写打开一个二进制文件，允许读或在文件末追加数据。  

       上述的形态字符串都可以再加一个b字符，如rb、w+b或ab＋等组合，加入b 字符用来告诉函数库打开的文件为二进制文件，而非纯文字文件。

1.2 fclose 函数说明

1.2.1 作用

关闭一个文件流，释放文件指针

1.2.2 格式

int fclose( FILE *fp );

12…3 返回值

如果流成功关闭，fclose 返回 0，否则返回EOF

1.2.4 参数说明

*fp：需要关闭的文件指针

注：在文件操作完成后我们应该调用该函数来关闭文件，如果不关闭文件将可能会丢失数据。因为在向文件写入数据时会先将数据输出到缓冲区，待缓冲区充满后才正式输出给文件。

2. 顺序读写数据文件

2.1 fgetc 函数说明

2.1.1 作用

从文件指针指向的文件流中读取一个字符，读取一个字节后，光标位置后移一个字节

2.1.2格式

int fgetc(FILE *stream);

2.1.3 返回值

返回所读取的一个字节，如果读到文件末尾或者读取出错时返回EOF(EOF是文件结束标识符,一般值为-1)

2.1.4 参数说明

*stream：文件指针，从该文件指针指向的文件中读取一个字符，然后将光标后移一个字节

2.2 fputc 函数说明

2.2.1作用

将指定字符写到文件指针所指向的文件的当前写指针位置上

2.2.2 格式

int fputc (char c, File *fp);

2.2.3 返回值

在正常调用情况下，函数返回写入文件的字符的ASCII码值，出错时，返回EOF

2.2.4 参数说明

c：需要写入的字符

*fp：文件指针，在当前文件指针所指向的文件的当前写指针位置上写入一个字符c，然后文件内部写指针会自动后移一个字节位置

2.3 fgets 函数说明

2…3.1 作用

从文件结构体指针stream中读取数据，每次读取一行。读取的数据保存在buf指向的字符数组中，每次最多读取bufsize-1个字符（第bufsize个字符赋’\0’），如果文件中的该行，不足bufsize个字符，则读完该行就结束。如若该行（包括最后一个换行符）的字符数超过bufsize-1，则fgets只返回一个不完整的行，但是，缓冲区总是以NULL字符结尾，对fgets的下一次调用会继续读该行。

2…3.2 格式

char *fgets(char *buf, int bufsize, FILE *stream);

2.3.3 返回值

函数成功将返回buf，失败或读到文件结尾返回NULL。因此我们不能直接通过fgets的返回值来判断函数是否是出错而终止的，应该借助feof函数或者ferror函数来判断。

2.3.4 参数说明

*buf: 字符型指针，指向用来存储所得数据的地址。  

bufsize: 整型数据，指明存储数据的大小。  

*stream: 文件指针，将要读取的文件流。

2.4 fprintf 函数说明

2.4.1 作用

格式化后输出到文件中

2.4.2格式

int fprintf (FILE* stream, const char* format, [argument]);

2.4.3 返回值

若成功返回值是输出的字符数，当发生错误时返回一个负值

2.4.4 参数说明

*stream：文件指针

*format：输出格式

[argument]：附加参数列表

注：用法与printf函数类似，这里只是参数多了一个文件指针，将格式后的结果输出到文件中

2.5 fscanf 函数说明

2.5.1 作用

从一个流中执行格式化输入

2.5.1 格式

int fscanf(FILE* stream,constchar* format,[argument]);

2.5.2 返回值

成功返回读入的参数的个数，失败返回EOF。

2.5.3 参数说明

*stream：文件指针

*format：格式字符串

[argument]：输入列表

注：用法与scanf函数类似

2.6 fread 函数说明

2.6.1 作用

从一个文件流中读数据，最多读取count个元素，每个元素size字节

2.6.2 格式

size_t fread ( void *buffer, size_t size, size_t count, FILE *stream) ;

2.6.3 返回值

如果调用成功返回实际读取到的元素个数，如果不成功或读到文件末尾返回0

2.6.4 参数说明

*buffer：用于接收数据的内存地址

size：要读的每个数据项的字节数，单位是字节

count：要读count个数据项，每个数据项size个字节

*stream：文件指针

注：这个函数以二进制形式对文件进行操作，不局限于文本文件

2.7 fwrite 函数说明

2.7.1 作用

向文件写入一个数据块

2.7.2 格式

size_t fwrite(const void* buffer, size_t size, size_t count, FILE* stream);

2.7.3 返回值

返回实际写入的数据块数目

2.7.4 参数说明

*buffer：待写入的数据的内存地址

size：要写入内容的单字节数

count：要进行写入size字节的数据项的个数

*stream：文件指针

注：这个函数以二进制形式对文件进行操作，不局限于文本文件

3. 随机读写数据文件

3.1 rewind 函数说明

3.1.1 作用

将文件内部的位置指针重新指向一个流（数据流/文件）的开头

3.1.2 格式

void rewind(FILE *stream);

3.1.3 返回值

无

3.1.4 参数说明

*stream：文件指针

3.2 ftell 函数说明

3.2.1 作用

得到文件位置指针当前位置相对于文件首的偏移字节数（测定文件位置标记的当前位置）

3.2.2 格式

long ftell(FILE *stream);

3.2.3 返回值

成功返回当前文件位置，失败返回-1L

3.2.4 参数说明

*stream：文件指针

注：因为ftell返回long型，根据long型的取值范围-231~231-1（-2147483648～2147483647），故对大于2.1G的文件进行操作时出错。

3.3 fseek 函数说明

3.3.1 作用

重定位流(数据流/文件)上的文件内部位置指针

3.3.2 格式

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

3.3.3 返回值

成功返回0，失败返回非0值

3.3.4 参数说明

*stream：文件指针

offset：偏移量，正数表示正向偏移，负数表示负向偏移。因为是long型数据，所以应在数字后面加一个字母L

origin：设定从文件的哪里开始偏移,可取值为：SEEK_CUR、 SEEK_END 或 SEEK_SET，详见下表：

名字 起始点 用数字代表

SEEK_SET 文件开始位置 0

SEEK_CUR 文件当前位置 1

SEEK_END 文件末尾位置 2

示例：

fseek(fp,100L,0); // 把位置指针移动到离文件开头100字节处

fseek(fp,100L,1); // 把位置指针移动到离文件当前位置100字节处

fseek(fp,-100L,2); // 把位置指针退回到离文件结尾100字节处

4. 文件读写的出错检测

4.1 ferror 函数说明

*stream：文件指针

4.1.1 作用

在调用各种输入输出函数（如 putc、getc、fread、fwrite等）时，如果出现错误，除了函数返回值有所反映外，还可以用ferror函数检查

4.1.2 格式

int ferror(FILE *stream);

4.1.3 返回值

返回0表示未出错，返回非0值表示出错

4.1.4 参数说明

4.2 clearerr 函数说明

4.2.1 作用

使文件错误标志和文件结束标志置为0。假设在调用一个输入输出函数时出现了错误，ferror函数值为一个非零值。在调用clearerr（fp）后，ferror（fp）的值变为0。只要出现错误标志，就一直保留，直到对同一文件调用clearerr函数或rewind函数，或任何其他一个输入输出函数。

4.2.2 格式

void clearerr(FILE *stream);

4.2.3 返回值

无

4.2.4 参数说明

*stream：文件指针