_fdopen, _wfdopen

将流与以前为低级别 I/O 而打开的文件相关联。

语法

FILE *_fdopen(
   int fd,
   const char *mode
);
FILE *_wfdopen(
   int fd,
   const wchar_t *mode
);

参数

fd
打开文件的文件描述符。

mode
文件访问的类型。

返回值

这些函数均返回指向打开流的指针。 一个 null 指针值指示错误。 出现错误时,会调用无效参数处理程序,如参数验证中所述。 如果允许继续执行,则 errno 会设置为 EBADF(这指示错误的文件描述符)或 EINVAL(这指示 mode 是空指针)。

有关这些和其他错误代码的详细信息,请参阅 errno_doserrno_sys_errlist_sys_nerr

备注

_fdopen 函数将 I/O 流与 fd 标识的文件相关联,从而允许对为低级别 I/O 而打开的文件进行缓冲和格式化。 _wfdopen_fdopen的宽字符版本; mode_wfdopen 参数是宽字符字符串。 除此以外,_wfdopen_fdopen 的行为完全相同。

传入 _fdopen 的文件描述符由返回的 FILE * 流拥有。 如果 _fdopen 成功,请不要对文件描述符调用 _close。 对返回的 FILE * 调用 fclose 也会关闭文件描述符。

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

字符串 mode 为文件指定请求的文件访问类型:

mode Access
"r" 打开以便读取。 如果文件不存在或找不到,fopen 调用将失败。
"w" 打开用于写入的空文件。 如果给定文件存在,则其内容会被销毁。
"a" 在文件末尾打开进行编写(追加)。 如果文件不存在,则创建文件。
"r+" 打开以便读取和写入。 文件必须存在。
"w+" 打开用于读取和写入的空文件。 如果文件存在,则其内容会被销毁。
"a+" 打开以进行读取和追加。 如果文件不存在,则创建文件。

使用 "a""a+" 访问类型打开文件时,所有写入操作均将在文件末尾进行。 使用 fseekrewind 可重新定位文件指针,但在执行任何写入操作前,文件指针将始终被移回文件末尾。这样就不会覆盖现有数据。 指定 "r+""w+""a+" 访问类型时,允许读取和写入(文件将处于打开状态以进行“更新”)。 但是,在读取与写入之间切换时,必须有中间 fflushfsetposfseekrewind 操作。 如果需要,可以为 fsetposfseek 操作指定当前位置。

除了以上值之外,还可以在 mode 中包含以下字符来指定换行符的转换模式:

mode 修饰符 行为
t 在文本(转换)模式下打开。 在这种模式下,输入时,回车换行 (CR-LF) 组合将转换为单一的换行 (LF);输出时,LF 字符将转换为 CR-LF 组合。 CTRL+Z 也将在输入时解释为文件尾字符。
b 在二进制(未转换)模式下打开。 会禁止从 t 模式进行任何转换。
c 启用关联 filename 的提交标志,以便在调用 fflush_flushall 时将文件缓冲区的内容直接写入磁盘。
n 将关联的 filename 的提交标志重置为“no-commit”。此标志为默认值。 如果将程序显式链接到 Commode.obj,它还将重写全局提交标志。 除非将程序显式链接到 Commode.obj,全局提交标志默认为“no-commit”。

tcmoden选项Microsoft扩展fopen和。_fdopen 如果要保留 ANSI 可移植性,请不要使用它们。

如果 tbmode 中未给出,则默认转换模式由全局变量 _fmode 定义。 如果 tb 是该参数的前缀,则函数将失败并返回 NULL。 有关文本模式和二进制模式的讨论,请参阅文本和二进制模式文件 I/O

fopen_fdopen 中使用的 mode 字符串的有效字符对应于在 _open_sopen 中使用的 oflag 自变量,如下表中所示:

字符串中的 mode 字符 _open_sopen 的等效 oflag
a _O_WRONLY | _O_APPEND (通常为 _O_WRONLY | _O_CREAT | _O_APPEND
a+ _O_RDWR | _O_APPEND (通常为 _O_RDWR | _O_APPEND | _O_CREAT
r _O_RDONLY
r+ _O_RDWR
w _O_WRONLY (通常为 _O_WRONLY | _O_CREAT | _O_TRUNC
w+ _O_RDWR (通常为 _O_RDWR | _O_CREAT | _O_TRUNC
b _O_BINARY
t _O_TEXT
c
n

要求

函数 必需的标头 C++ 标头
_fdopen <stdio.h> <cstdio>
_wfdopen <stdio.h><wchar.h> <cstdio>

有关 C 运行时库中的标准符合性和命名约定的详细信息,请参阅兼容性

一般文本例程映射

<tchar.h> 例程 _UNICODE_MBCS 未定义 _MBCS 已定义 _UNICODE 已定义
_tfdopen _fdopen _fdopen _wfdopen

示例

// crt_fdopen.c
// This program opens a file by using low-level
// I/O, then uses _fdopen to switch to stream
// access. It counts the lines in the file.

#include <stdlib.h>
#include <stdio.h>
#include <fcntl.h>
#include <io.h>
#include <share.h>

int main( void )
{
   FILE *stream;
   int  fd, count = 0;
   char inbuf[128];

   // Open a file.
   if( _sopen_s( &fd, "crt_fdopen.txt", _O_RDONLY, _SH_DENYNO, 0 ) )
      exit( 1 );

   // Get stream from file descriptor.
   if( (stream = _fdopen( fd, "r" )) == NULL )
      exit( 1 );

   while( fgets( inbuf, 128, stream ) != NULL )
      count++;

   // After _fdopen, close by using fclose, not _close.
   fclose( stream );
   printf( "Lines in file: %d\n", count );
}

输入:crt_fdopen.txt

Line one
Line two

输出

Lines in file: 2

另请参阅

流 I/O
_dup, _dup2
fclose, _fcloseall
fopen, _wfopen
freopen, _wfreopen
_open, _wopen