std::wctob

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

字符串库

空终止字符串

字节字符串

多字节字符串

宽字符串

类

basic_string

basic_string_view (C++17)

char_traits

 

空终止多字节字符串

宽/多字节转换
mbsinit
mbtowc mbstowcs btowc mbrtowc mbsrtowcs mbrtoc8 (C++20) mbrtoc16 (C++11) mbrtoc32 (C++11) mblen	wctomb wcstombs wctob wcrtomb wcsrtombs c8rtomb (C++20) c16rtomb (C++11) c32rtomb (C++11) mbrlen
类型
mbstate_t

 

在标头 <cwchar> 定义
int wctob( std::wint_t c );

窄化宽字符 c，若其多字节字符等价版本在初始迁移状态为单字节。

这典型地对来自 ASCII 字符集的字符可行，因为大多数多字节编码（例如 UTF-8）用单字节编码那些字符。

参数

c

-

要窄化的宽字符

返回值

若 c 在初始迁移状态不表示长度为 1 的多字节字符则为 EOF。

否则，为作为 unsigned char 的 c 的单字节表示，转换为 int。

示例

运行此代码

#include <clocale>
#include <cwchar>
#include <iostream>
 
void try_narrowing(wchar_t c)
{
    int cn = std::wctob(c);
    if (cn != EOF)
        std::cout << '\'' << int(c) << "' 窄化为 " << +cn << '\n';
    else
        std::cout << '\'' << int(c) << "' 无法窄化\n";
}
 
int main()
{
    std::setlocale(LC_ALL, "th_TH.utf8");
    std::cout << std::hex << std::showbase << "在泰语 UTF-8 本地环境中:\n";
    try_narrowing(L'a');
    try_narrowing(L'๛');
 
    std::setlocale(LC_ALL, "th_TH.tis620");
    std::cout << "在泰语 TIS-620 本地环境中:\n";
    try_narrowing(L'a');
    try_narrowing(L'๛');
}

输出：

在泰语 UTF-8 本地环境中:
'0x61' 窄化为 0x61
'0xe5b' 无法窄化
在泰语 TIS-620 本地环境中:
'0x61' 窄化为 0x61
'0xe5b' 窄化为 0xfb

参阅

btowc	若可能，则加宽单字节窄字符为宽字符 (函数)
narrow	窄化字符 (std::basic_ios<CharT,Traits> 的公开成员函数)
narrow	调用 do_narrow (std::ctype<CharT> 的公开成员函数)