freopen，_wfreopen

重新分配文件指针。 提供这些函数的更安全版本；请参阅 freopen_s、_wfreopen_s。

语法

FILE *freopen(
   const char *path,
   const char *mode,
   FILE *stream
);
FILE *_wfreopen(
   const wchar_t *path,
   const wchar_t *mode,
   FILE *stream
);

参数

path
新文件的路径。

mode
允许的访问类型。

stream
指向 FILE 结构的指针。

返回值

这些函数均返回指向新打开的文件的指针。 如果发生错误，则关闭原始文件，且函数返回 NULL 指针值。 如果 path、mode 或 stream 是空指针，或者如果 filename 是空字符串，这些函数会调用无效参数处理程序，如参数验证中所述。 如果允许执行继续，则这些功能将 errno 设置为 EINVAL 并返回 NULL。

有关错误代码的详细信息，请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。

注解

这些函数存在更安全版本；请参阅 freopen_s、_wfreopen_s。

freopen 函数会关闭当前与 stream 关联的文件，并将 stream 重新分配到 path 指定的文件。 _wfreopen 是 _freopen 的宽字符版本；_wfreopen 的 path 和 mode 参数是宽字符串。 除此以外，_wfreopen 和 _freopen 的行为完全相同。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

一般文本例程映射

TCHAR.H 例程	_UNICODE 和 _MBCS 未定义	_MBCS 已定义	_UNICODE 已定义
_tfreopen	freopen	freopen	_wfreopen

freopen 通常用于将预先打开的文件 stdin、stdout 和 stderr 重定向到用户指定的文件。 与 stream 关联的新文件使用 mode 打开，它是指定文件要求的访问权限类型的字符串，如下所述：

mode	Access
"r"	打开以便读取。 如果文件不存在或找不到，freopen 调用将失败。
"w"	打开用于写入的空文件。 如果给定文件存在，则其内容会被销毁。
"a"	在文件末尾打开以进行写入（追加），在新数据写入到文件之前不移除文件末尾 (EOF) 标记。 如果文件不存在，则创建文件。
"r+"	打开以便读取和写入。 文件必须存在。
"w+"	打开用于读取和写入的空文件。 如果文件存在，则其内容会被销毁。
"a+"	打开以进行读取和追加。 追加操作包括在新数据写入文件之前移除 EOF 标记。 写入完成后，EOF 标记不会还原。 如果文件不存在，则创建文件。

使用 "w" 和 "w+" 类型时要小心，因为它们可能会破坏现有文件。 从 C11 开始，可以将 "x" 追加到 "w"，或追加 "w+" 以使函数在该文件存在时失败，而不是覆盖该文件。

使用 "a" 或 "a+" 访问类型打开文件时，所有写入操作均将在文件末尾进行。 虽然使用 fseek 或 rewind 可重新定位文件指针，但在执行任何写入操作前，文件指针将始终被移回文件末尾。因此，无法覆盖现有数据。

在 EOF 标记追加到文件之前，"a" 模式会将其删除。 在追加后，MS-DOS TYPE 命令只显示原始 EOF 标记之前的数据，不显示追加到文件的任何数据。 在 EOF 标记追加到文件之前，"a+" 模式会将其删除。 在追加后，MS-DOS TYPE 命令显示文件中的所有数据。 需使用 "a+" 模式才能附加到通过 CTRL+Z EOF 标记终止的流文件。

指定 "r+"、"w+" 或 "a+" 访问类型时，允许读取和写入（文件将处于打开状态以进行“更新”）。 但是，在读取与写入之间切换时，必须有中间 fsetpos、fseek 或 rewind 操作。 如果需要的话，可以为 fsetpos 或 fseek 操作指定当前位置。 除上述值之外，还可以在 mode 字符串中包含以下字符之一以指定新行的转换模式。

mode 修饰符	转换模式
t	在文本（转换）模式下打开。
b	在二进制（未转换）模式下打开；禁止涉及回车和换行字符的转换。

在文本（已转换）模式下，输入时，回车-换行 (CR-LF) 组合将转换为单一的换行 (LF) 字符；输出时，LF 字符将转换为 CR-LF 组合。 CTRL+Z 也将在输入时解释为文件尾字符。 在打开以便利用 "a+" 进行读取或读写的文件中，运行时库将检查文件末尾的 CTRL+Z，并在可能的情况下将其删除。 会移除它，因为使用 fseek 和 ftell 在文件中移动时，可能导致 fseek 在文件末尾附近错误运行。 如果需要 ANSI 可移植性，请不要使用 t 选项，因为它是 Microsoft 扩展。

如果 t 或 b 在 mode 中未给出，则默认转换模式由全局变量 _fmode 定义。 如果 t 或 b 是该参数的前缀，则函数将失败并返回 NULL。

有关文本模式和二进制模式的讨论，请参阅文本和二进制模式文件 I/O。

要求

函数	必需的标头
freopen	<stdio.h>
_wfreopen	<stdio.h> 或 <wchar.h>

通用 Windows 平台 (UWP) 应用中不支持控制台。 与控制台、stdin、stdout 和 stderr 关联的标准流句柄必须重定向，然后 C 运行时函数才能在 UWP 应用中使用它们。 有关兼容性的详细信息，请参阅 兼容性。

示例

// crt_freopen.c
// compile with: /W3
// This program reassigns stderr to the file
// named FREOPEN.OUT and writes a line to that file.
#include <stdio.h>
#include <stdlib.h>

FILE *stream;

int main( void )
{
   // Reassign "stderr" to "freopen.out":
   stream = freopen( "freopen.out", "w", stderr ); // C4996
   // Note: freopen is deprecated; consider using freopen_s instead

   if( stream == NULL )
      fprintf( stdout, "error on freopen\n" );
   else
   {
      fprintf( stdout, "successfully reassigned\n" ); fflush( stdout );
      fprintf( stream, "This will go to the file 'freopen.out'\n" );
      fclose( stream );
   }
   system( "type freopen.out" );
}

successfully reassigned
This will go to the file 'freopen.out'

另请参阅

流 I/O
fclose、_fcloseall
_fdopen、_wfdopen
_fileno
fopen、_wfopen
_open、_wopen
_setmode