fgetwc, getwc

定义于头文件 `<wchar.h>`
wint_t fgetwc( FILE *stream );		(C95 起)
wint_t getwc( FILE *stream );		(C95 起)

从给定的输入流读取下一个宽字符。getwc() 可能被实现为宏，并且可能多次求值 stream。

内容

1 参数
2 返回值
3 示例
4 参考文献
5 参见

[编辑] 参数

stream

-

从中读取宽字符的流

[编辑] 返回值

流中的下一个宽字符，失败时返回 WEOF。

如果失败是由文件结束条件引起的，则额外在 stream 上设置 eof 指示器（参见 feof()）。如果失败是由其他错误引起的，则在 stream 上设置 error 指示器（参见 ferror()）。

如果发生编码错误，则额外设置 errno 为 EILSEQ。

[编辑] 示例

运行此代码

#include <stdio.h>
#include <stdlib.h>
#include <wchar.h>
#include <errno.h>
#include <locale.h>
 
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
    FILE *fp = fopen("fgetwc.dat", "w");
    if(!fp) {
        perror("Can't open file for writing");
        return EXIT_FAILURE;
    }
    fputs("кошка\n", fp);
    fclose(fp);
 
    fp = fopen("fgetwc.dat", "r");
    if(!fp) {
        perror("Can't open file for reading");
        return EXIT_FAILURE;
    }
    wint_t wc;
    errno = 0;
    while ((wc = fgetwc(fp)) != WEOF)
        putwchar(wc);
 
    if (ferror(fp)) {
        if (errno == EILSEQ)
            puts("Character encoding error while reading.");
        else
            puts("I/O error when reading");
    } else if (feof(fp))
        puts("End of file reached successfully");
 
    fclose(fp);
}

输出

кошка

[编辑] 参考文献

C17 标准 (ISO/IEC 9899:2018)

7.29.3.1 fgetwc 函数 (页: 307-308)

7.29.3.6 getwc 函数 (页: 309)

C11 标准 (ISO/IEC 9899:2011)

7.29.3.1 fgetwc 函数 (页: 421-422)

7.29.3.6 getwc 函数 (页: 424)

C99 标准 (ISO/IEC 9899:1999)

7.24.3.1 fgetwc 函数 (页: 367)

7.24.3.6 getwc 函数 (页: 369)

[编辑] 参见

fgetcgetc	从文件流中获取一个字符 (函数) [编辑]
fgetws (C95)	从文件流中获取一个宽字符串 (函数) [编辑]
fputwcputwc (C95)	向文件流写入一个宽字符 (函数) [编辑]
ungetwc (C95)	将一个宽字符放回文件流 (函数) [编辑]
C++ 文档，关于 fgetwc

编译器支持
语言
头文件
类型支持
程序实用工具
可变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间实用工具
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

cppreference.cn

命名空间

变体

视图

操作