命名空间
变体
操作

fwide

来自 cppreference.com
< c‎ | io
 
 
文件输入/输出
类型和对象
函数
文件访问
fwide
(C95)
直接输入/输出
非格式化输入/输出
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)
格式化输入
(C99)(C99)(C99)(C11)(C11)(C11)     
 
在头文件 <wchar.h> 中定义
int fwide( FILE *stream, int mode );
(自 C95 起)

如果 mode > 0,则尝试使 stream 成为宽字符定向的。如果 mode < 0,则尝试使 stream 成为字节定向的。如果 mode==0,则只查询流的当前方向。

如果流的方向已经确定(通过执行输出或通过之前调用 fwide),则此函数不执行任何操作。

内容

[编辑] 参数

stream - 指向要修改或查询的 C I/O 流的指针
mode - 大于零的整数值表示将流设置为宽字符定向,小于零的整数值表示将流设置为字节定向,零表示只查询

[编辑] 返回值

如果流在此调用后是宽字符定向的,则返回大于零的整数;如果流在此调用后是字节定向的,则返回小于零的整数;如果流没有方向,则返回零。

[编辑] 示例

以下代码设置并重置流方向。

#include <wchar.h>
#include <stdio.h>
#include <stdlib.h>
 
void show_orientation(int n)
{
    n < 0 ? puts("\tnarrow orientation"):
    n > 0 ? puts("\twide orientation"):
            puts("\tno orientation");
}
 
void try_read(FILE* fp)
{
    int c = fgetc(fp);
    if(c == EOF)
        puts("\tnarrow character read failed");
    else
        printf("\tnarrow character read '%c'\n", c);
 
    wint_t wc = fgetwc(fp);
    if(wc == WEOF)
        puts("\twide character read failed");
    else
        printf("\twide character read '%lc'\n", wc);
}
 
int main(void)
{
    enum fwide_orientation { narrow = -1, query, wide };
 
    FILE* fp = fopen("main.cpp", "r");
    if (!fp)
    {
        perror("fopen() failed");
        return EXIT_FAILURE;
    }
 
    puts("1) A newly opened stream has no orientation.");
    show_orientation(fwide(fp, query));
 
    puts("2) Establish byte orientation.");
    show_orientation(fwide(fp, narrow));
    try_read(fp);
 
    puts("3) Only freopen() can reset stream orientation.");
    if (freopen("main.cpp", "r", fp) == NULL)
    {
       perror("freopen() failed");
       return EXIT_FAILURE;
    }
 
    puts("4) A reopened stream has no orientation.");
    show_orientation(fwide(fp, query));
 
    puts("5) Establish wide orientation.");
    show_orientation(fwide(fp, wide));
    try_read(fp);
 
    fclose(fp);
}

可能的输出

1) A newly opened stream has no orientation.
	no orientation
2) Establish byte orientation.
	narrow orientation
	narrow character read '#'
	wide character read failed
3) Only freopen() can reset stream orientation.
4) A reopened stream has no orientation.
	no orientation
5) Establish wide orientation.
	wide orientation
	narrow character read failed
	wide character read '#'

[编辑] 参考资料

  • C17 标准 (ISO/IEC 9899:2018)
  • 7.29.3.5 fwide 函数 (p: 309)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.29.3.5 fwide 函数 (p: 423)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.24.3.5 fwide 函数 (p: 369)

[编辑] 参见

打开文件
(函数) [编辑]
C++ 文档 对于 fwide