C/C++ 中的 putwchar() 函数

简介

putwchar() 是一种输出函数，用于输出一个宽字符（wchar_t 类型）到标准输出设备（例如控制台或文件）。它是 C/C++ 标准库中的一部分，需要引用头文件 wchar.h。

putwchar() 函数的形式如下：

wint_t putwchar(wchar_t wchar);

其中，wint_t 是一个整数类型，存储了输出的宽字符的值，或者在遇到错误时返回一个非零值（与 EOF 不同）。wchar_t 是宽字符类型，表示要输出的字符。

用法示例

下面是一个简单的使用 putwchar() 函数输出宽字符的示例：

#include <wchar.h>

int main() {
    wchar_t ch = L'你';
    putwchar(ch);
    return 0;
}

如上代码片段所示，我们在程序中定义了一个宽字符变量 ch，其值为中文字符“你”。然后通过 putwchar() 函数将其输出。

需要注意的是，由于控制台默认使用的字符集为 GBK，因此如果我们直接向控制台输出一个宽字符，会导致其无法正确显示，而输出一些乱码字符。因此，如果要在控制台中正确输出宽字符，需要先修改控制台字符集为 utf-8，例如使用以下语句：

system("chcp 65001");

这里的 chcp 表示 change code page，其参数 65001 表示 utf-8 字符集。

注意事项

• putwchar() 函数只能输出一个宽字符，无法输出字符串；
• putwchar() 函数输出成功时返回输出的宽字符值，输出失败时返回一个非零值，但不同于 EOF。

总结

putwchar() 函数是 C/C++ 中常用的宽字符输出函数，用于将一个宽字符输出到标准输出设备中。通过该函数，我们可以在控制台、文件等输出设备中正确地输出宽字符，向用户提供更好的用户体验。在真正的项目中，我们会使用该函数的变种，例如 _putwch()、_putws() 等，更好地满足不同的输出需求。