%>

关闭当前与 oldStream 关联的文件,并将 stream 重新分配给 fileName 指定的文件。

这些版本的 freopen_wfreopen 具有安全性增强功能,如 CRT 中的安全性功能中所述。

语法

errno_t freopen_s(
   FILE ** stream,
   const char * fileName,
   const char * mode,
   FILE* oldStream
);

errno_t _wfreopen_s(
   FILE ** stream,
   const wchar_t * fileName,
   const wchar_t * mode,
   FILE * oldStream
);

参数

stream
一个 out 参数,该参数将在函数返回时指向重新打开的流。

fileName
要重新打开的文件的路径。

mode
重新打开的流的模式。

oldStream
要重新打开的流。 它已刷新,与之关联的任何文件都已关闭。

返回值

如果成功,则为零;否则为错误代码。 如果发生错误,则关闭原始文件并将 NULL 写入 stream,除非 stream 也是 NULL

有关错误代码的详细信息,请参阅 errno_doserrno_sys_errlist_sys_nerr

注解

freopen_s 函数通常用于将与 stdinstdoutstderr 关联的预先打开的流附加到另一个文件。

freopen_s 函数会关闭当前与 stream 关联的文件,并将 stream 重新分配到 path 指定的文件。 _wfreopen_sfreopen_s 的宽字符版本;_wfreopen_spathmode 参数是宽字符串。 除此以外,_wfreopen_sfreopen_s 的行为完全相同。

如果 pFilepathmodestream 中的任一个是 NULL,或者如果 path 是一个空字符串,这些函数会调用无效参数处理程序,如参数验证中所述。 如果允许执行继续,则这些功能将 errno 设置为 EINVAL 并返回 EINVAL

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

一般文本例程映射

TCHAR.H 例程 _UNICODE_MBCS 未定义 _MBCS 已定义 _UNICODE 已定义
_tfreopen_s freopen_s freopen_s _wfreopen_s

freopen_s 通常用于将预先打开的文件 stdinstdoutstderr 重定向到用户指定的文件。 与 stream 关联的新文件使用 mode 打开,它是指定文件要求的访问权限类型的字符串,如下所述:

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

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

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

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

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

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

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

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

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

要求

函数 必需的标头
freopen_s <stdio.h>
_wfreopen_s <stdio.h><wchar.h>

通用 Windows 平台 (UWP) 应用中不支持控制台。 与控制台、stdinstdoutstderr 关联的标准流句柄必须重定向,然后 C 运行时函数才能在 UWP 应用中使用它们。

有关兼容性的详细信息,请参阅 兼容性

示例

// crt_freopen_s.c
// 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 )
{
   errno_t err;
   // Reassign "stderr" to "freopen.out":
   err = freopen_s( &stream, "freopen.out", "w", stderr );

   if( err != 0 )
      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'

另请参阅

Stream I/O
%>
%>
%>
_fileno
%>
%>
_setmode