当前位置: C语言 -- 标准库 -- <wchar.h> -- getwc

getwc函数


概要:
#include <stdio.h>
#include <wchar.h>
wint_t getwc(FILE *stream);

描述:

该函数从参数stream指向的输入流中读取一个宽字符,具体步骤:如果参数stream指向输入流未设置文件末尾指示符(end-of-file indicator),并且存在下一个宽字符,函数将读取该宽字符,同时将字符类型从wchar_t类型转换为wint_t类型;如果定义了文件位置指示符,并前进文件位置指示符。

:根据ISO/IEC 9899:2018标准第7.21.3 Files节,文件打开时,如果文件支持定位请求,与流相关联的文件位置指示符指示位置在文件开始处(即0号字符。);除非使用a模式打开文件,这种情况下,文件位置指示符指示位置是文件开始处,还是文件末尾处将由实现定义。

该函数等价于fgetwc函数,唯一的区别在于:如果实现将getwc定义为函数式宏,可能会对参数stream多次评估,因此参数stream应为不带副作用的表达式;而fgetwc只能以函数形式实现。


参数:
FILE *stream

FILE类型指针,指向输入流。


返回值:

如果设置了流的文件末尾指示符,或者如果流处于文件末尾位置,将设置流的文件末尾指示符,函数返回WEOF;否则函数返回读取的宽字符。如果发生读取错误,将给流设置错误指示符(error indicator),并返回WEOF。如果发生编码错误(包括太少的字节。),函数将返回WEOF,并将宏EILSEQ存入errno


范例:
1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
/*函数getwc范例*/

#include <locale.h>
#include <stdio.h>
#include <wchar.h>

int main(void)
{
    setlocale(LC_ALL, "");

    wint_t ch;
    int count = 0;  //统计字数。
    FILE *pFile;

    pFile = fopen("gch.txt", "r");
    while((ch=getwc(pFile)) != WEOF)
    {
        ++count;
    }

    fclose(pFile);

    wprintf(L"共%d个字。", count);

    return 0;
}


结果:

假设gch.txt文件内容为:

把时间用在思考上是最能节省时间的事情。

将输出:

共19个字。

:使用Visual Studio编译。这里文本文件使用ANSI编码;ANSI编码详细介绍请查阅百度百科。


相关内容:
fgetws 从输入流读取宽字符串的函数。
fgetwc 从输入流读取宽字符的函数。
getwchar 从标准输入流读取宽字符的函数。
ungetwc 将宽字符推回输入流的函数。