_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+" 访问类型打开文件时，所有写入操作均将在文件末尾进行。 使用 fseek 或 rewind 可重新定位文件指针，但在执行任何写入操作前，文件指针将始终被移回文件末尾。这样就不会覆盖现有数据。 指定 "r+"、"w+" 或 "a+" 访问类型时，允许读取和写入（文件将处于打开状态以进行“更新”）。 但是，在读取与写入之间切换时，必须有中间 fflush、fsetpos、fseek 或 rewind 操作。 如果需要，可以为 fsetpos 或 fseek 操作指定当前位置。

除了以上值之外，还可以在 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”。

t、c 和 nmode 选项是适用于 fopen 和 _fdopen 的 Microsoft 扩展。 如果要保留 ANSI 可移植性，请不要使用它们。

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