_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”。 |
和tcmoden选项Microsoft扩展fopen和。_fdopen 如果要保留 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