C语言标准IO

fopen

fopen()函数用来打开文件。所有文件操作的第一步，都是使用fopen()打开指定文件。这个函数的原型定义在头文件stdio.h

• 函数原型

#include <stdio.h>
FILE *fopen(const char *path, const char *mode);
FILE *fdopen(int fd, const char *mode);
FILE *freopen(const char *path, const char *mode, FILE *stream);
1
2
3
4

• 参数

path 要打开的文件路径名

mode 文件的打开方式，6种取值

mode

• r：读模式，只用来读取数据。如果文件不存在，返回 NULL 指针。

• w：写模式，只用来写入数据。如果文件存在，文件长度会被截为0，然后再写入；如果文件不存在，则创建该文件。

• a：写模式，只用来在文件尾部追加数据。如果文件不存在，则创建该文件。c

• r+：读写模式。如果文件存在，指针指向文件开始处，可以在文件头部添加数据。如果文件不存在，返回 NULL 指针。

• w+：读写模式。如果文件存在，文件长度会被截为0，然后再写入数据。这种模式实际上读不到数据，反而会擦掉数据。如果文件不存在，则创建该文件。

• a+：读写模式。如果文件存在，指针指向文件结尾，可以在现有文件末尾添加内容。如果文件不存在，则创建该文件

• 返回值

如果调用成功，返回文件指针；否则返回NULL并设置适当的errno信息。

fwrite

fwrite()用来一次性写入较大的数据块，主要用途是将数组数据一次性写入文件，适合写入二进制数据。它的原型定义在stdio.h

• 函数原型

#include <stdio.h>
size_t fwrite(const void *ptr,size_t size,size_t n,FILE *fp);
1
2

• 参数

ptr：数组地址。
size：每个数组成员的大小，单位为字节。
nmemb：数组的成员数量。
fp：文件指针。

• 返回值

返回写入的数据的个数。
如果成功写入则，文件内部指针会向右移动n*size。

fread

fread()函数用于一次性从文件读取较大的数据块，主要用途是将文件内容读入一个数组，适合读取二进制数据。它的原型定义在头文件stdio.h

• 函数原型

#include <stdio.h>
size_t fread(void *ptr,size_t size,size_t n,FILE *fp);
1
2

• 参数

与fwrite含义相同。

• 返回值

fread不区分文件结束和错误。如有必要，请使用feof和ferror。

fclose

关闭fopen打开的文件

• 函数原型

#include <stdio.h>
int fclose(FILE *fp);
1
2

• 参数

参数为文件指针

• 返回值

fputs

写入字符串到文件

• 函数原型

#include <stdio.h>
int fputs(const char *s,FILE *fp);
1
2

• 功能描述

将s指向的字符串，舍去结束标记’\0’后写入到fp指向的文件缓冲区。

• 返回值

返回写入的实际字符数；出现错误，返回EOF。

fgets

从文件读取字符串

• 函数原型

char *fgets(char *s,int size,FILE *fp);
1

• 功能描述

从fp所指向的文件缓冲区当前位置读取n-1个字符，
在其后补充一个’\0’，并写入到s指向的内存区。

• 返回值

返回s对应的地址，可以理解为返回字符串。出现错误返回NULL。

ferror

ferror()函数用来返回错误指示器的状态。可以通过这个函数，判断前面的文件操作是否成功。它的原型定义在头文件stdio.h

• 函数原型

int feof(FILE *fp);
int ferror(FILE *fp);
1
2

• 功能描述

• feof

测试fp指向的流是否设置了EOF标记（end-of-file indicator）。
即是否到达文件结尾。
该标记只能被clearerr函数清除。
若fp当前位置是文件结尾，则返回非0值，否则返回0。

• ferror

测试fp指向的流是否设置了错误标记（error indicator）。
是否到达文件结尾。
该标记只能被clearerr函数清除。
若该标记被设置，则返回非0值。即表示出错。

• 示例

...
while(!feof(fp))
{
    ...
}
1
2
3
4
5

rewind

rewind英文释义是倒带的意思。这里是重置文件指针到所指向的文件的开始位置。

• 函数原型

#include <stdio.h>
void rewind(FILE *fp);
1
2

fseek

用于跳跃式地移动文件读写位置。

• 函数原型

#include <stdio.h>
int fseek(FILE *fp,long offset,int whence);
1
2

• 参数

offset为相较whence的偏移量。
whence为文件内部指针的基准：

• SEEK_SET 文件开始位置，其值为0

• SEEK_CUR 文件当前位置，其值为1

• SEEK_END 文件结束位置，其值为2

• 返回值

如果执行成功，将返回0。如果失败返回-1