freopen, freopen_s

来自cppreference.com
< c‎ | io
 
 
文件输入/输出
函数
文件访问
freopenfreopen_s

(C11)
(C95)
直接输入/输出
无格式输入/输出
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
格式输入
格式输出
文件定位
错误处理
文件操作
 
定义于头文件 <stdio.h>
(1)
FILE *freopen( const char *filename, const char *mode,
               FILE *stream );
(C99 前)
FILE *freopen( const char *restrict filename, const char *restrict mode,
               FILE *restrict stream );
(C99 起)
errno_t freopen_s(FILE *restrict *restrict newstreamptr,

                  const char *restrict filename, const char *restrict mode,

                  FILE *restrict stream);
(2) (C11 起)
1) 首先试图关闭关联到stream的文件,忽略任何错误。然后若filename非空,则试图用mode打开以filename指定的文件,如同用fopen,然后将该文件关联到stream所指向的文件流。若filename是空指针,则函数试图重打开已经关联到stream的文件(此情况是否允许更改模式是实现定义的)。
2)(1),除了以fopen_s中的方式处理mode,且对写入newstreamptr指向文件流的指针,还在运行时检测下列错误,并调用当前安装的制约处理函数:
  • newstreamptr是空指针
  • stream是空指针
  • mode是空指针
同所有边界检查函数, freopen_s 仅若实现定义了 __STDC_LIB_EXT1__ ,且用户在包含 <stdio.h> 前定义 __STDC_WANT_LIB_EXT1__ 为整数常量 1 才保证可用。

目录

[编辑] 参数

filename - 要关联到文件流的文件名
mode - 确定文件访问模式的空终止字符串
文件访问
模式字符串
含义 解释 若文件已存在的动作 若文件不存在的动作
"r" 打开文件以读取 从头读 打开失败
"w" 创建文件以写入 销毁内容 创建新文件
"a" 后附 后附到文件 写到结尾 创建新文件
"r+" 读扩展 打开文件以读/写 从头读 错误
"w+" 写扩展 创建文件以读/写 销毁内容 创建新文件
"a+" 后附扩展 打开文件以读/写 写到结尾 创建新文件
文件访问模式标签"b"可以可选地指定以二进制模式打开文件。此标签仅在Windows系统上生效。
在附加文件访问模式下,数据被写入到文件尾,而不考虑文件位置指示器的当前位置。
当文件以更新模式打开时('+'作为上述模式参数值列表的第二或第三个字符),访问流可以进行输入和输出。然而输出不应直接紧随输入,而中间无对fflush函数或对文件定位函数(fseekfsetposrewind)的调用,且输入不应直接紧随输出,而中间无对文件定位函数的调用,除非输入操作遇到文件尾。在一些实现中,以更新模式打开(或创建)文本文件可能取代打开(或创建)二进制流。
文件访问模式标签"x"可以可选地后附于"w"或"w+"指定符。若文件存在,则此标签强制函数失败,而不重写它。(C11)
使用fopen_sfreopen_s时,任何以"w"或"a"创建的文件的文件访问许可禁止其他用户访问它。文件访问模式标签"u"可以可选地前附于任何以为"w"或"a"始的指定符,以启用默认的fopen许可。(C11)
stream - 要修改的文件流
newstreamptr - 指向函数存储结果所用指针的指针(输出参数)

[编辑] 返回值

1) 成功时为stream值的副本,失败时为空指针。
2) 成功时为零(且stream值的副本会被写入*newstreamptr),失败时为非零(且空指针会被写入*newstreamptr,除非newstreamptr自身是空指针)。

[编辑] 注意

freopen是在文件流的窄/宽面向一旦被I/O操作或fwide建立后,仅有的改变它的方法。

[编辑] 示例

下列代码重定向stdout到文件。

#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    puts("stdout is printed to console");
    if (freopen("redir.txt", "w", stdout) == NULL)
    {
       perror("freopen() failed");
       return EXIT_FAILURE;
    }
    puts("stdout is redirected to a file"); // 这被写入redir.txt
    fclose(stdout);
}

输出:

stdout is printed to console

[编辑] 参考

  • C11 standard (ISO/IEC 9899:2011):
  • 7.21.5.4 The freopen function (p: 307)
  • K.3.5.2.2 The freopen_s function (p: 590)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.19.5.4 The freopen function (p: 272-273)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.9.5.4 The freopen function

[编辑] 参阅

打开文件
(函数) [编辑]
关闭文件
(函数) [编辑]
freopenC++ 文档