重新分配文件指针。 提供这些函数的更安全版本；请参阅 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'