fopen, fdopen, freopen

SYNOPSIS (总览)

#include <stdio.h>

FILE *fopen(const char *path, const char *mode);
FILE *fdopen(int fildes, const
char *mode);
FILE *freopen(const char
*path, const char *mode, FILE
*stream);

DESCRIPTION 描述

函数 fopen 打开一个文件, 并且分配一个流, 文件名由字符串
path 指定.

参数 mode 指向一个字符串, 该字符串用下面的字符串开头 (之后可以有附加的字符):

r: 为读操作打开文本文件. 流被定位于文件的开始.
r+: 为读写操作打开文本文件. 流被定位于文件的开始.
w: 为写操作创建文本文件, 或者将已经存在的文件长度截断为零. 流被定位于文件的开始.
w+: 为读写操作打开文件. 如果文件不存在, 就创建它, 否则将它截断. 流被定位于文件的开始.
a: 为追加操作 (在文件尾写) 打开文件. 如果文件不存在, 就创建它. 流被定位于文件的末尾.
a+: 为追加操作 (在文件尾写) 打开文件. 如果文件不存在, 就创建它. 读文件的初始位置是文件的开始, 但是写文件总是被追加到
文件的末尾.

可以把字母 ``b'' 添加到字符串 mode 的末尾, 或者插到上面任何两个字符的字符串的中间. 这样只是为了
和 ANSI X3.159-1989 (``ANSI C'') 标准严格保持兼容, 没有实际的效果; 在所有遵循 POSIX 的系统中,
``b'' 都被忽略, 包括 Linux. (其他系统可能会分别对待文本文件和二进制文件, 如果在进行二进制文件的 I/O, 那么添加
``b'' 是个好主意, 因为你的程序可能会被移植到非 Unix 环境中.)

在读/写流上可以任意顺序混合进行读写操作. 注意 ANSI C 要求在输出和输入操作之间插入一个文件定位函数, 除非
输入操作遇到了文件结束符. (如果不是这种情况, 那么读操作总是返回写操作的结果而不是最后的内容.) 因此, 最好 (在 Linux 中
有时是必须的) 对这样的流的写/读操作之间加入一个 fseek 或是 fgetpos 操作. 这个操作可以是一个
空操作 (如 fseek(..., 0L, SEEK_CUR)), 只利用其文件同步这个副效应.

用追加方式打开文件 (a 作为 mode 的第一个字符) 将使得所有后续的写操作发生在文件末尾, 如同之前
调用了

: fseek(stream,0,SEEK_END);

一样.

fdopen 函数将一个流和已存在的文件描述符 fildes 联系起来. 流的操作模式 mode
(取值为 "r", "r+", "w", "w+", "a", "a+" 之一) 必须与该文件描述符的操作模式一致. 流的定位标识设置为
fildes 原有的值, 清除错误标记和文件结束标记. 模式 "w" 或者 "w+" 不会截断文件. fdopen 不复制
文件描述符, 在关闭 fdopen 创建的流时, 也不关闭该文件描述符. 对共享内存对象实施 fdopen 的结果
没有定义.

freopen 函数打开用 path 说明的文件, 并且和 stream 指定的流联系起来.
原来的流 (如果存在的话) 被关闭. 参数 mode 和 fopen 中的用法一样. freopen 函数
主要的用处是改变标准文本流 (stderr, stdin, 或 stdout) 联系的文件.

RETURN VALUE (返回值)

如果操作成功, fopen, fdopen 和
freopen 返回一个指向文件对象 FILE 的指针, 否则返回 NULL 并设置全局变量
errno 来指出错误的发生.

ERRORS

EINVAL: fopen, fdopen, 或 freopen 提供的参数 mode 无效.

fopen, fdopen 和 freopen 也有可能失败并置 errno 为
malloc(3) 指定的值.

fopen 也有可能失败并置 errno 为 open(2) 指定的值.

fdopen 也有可能失败并置 errno 为 fcntl(2) 指定的值.

freopen 也有可能失败并置 errno 为 open(2),
fclose(3) 和 fflush(3) 指定的值.