Namespaces
Variants

std::ctype<CharT>:: widen, do_widen

From cppreference.net
C++
Text processing library
Localization library
std::ctype
定义于头文件 <locale>
public :
CharT widen ( char c ) const ;
(1)
public :
const char * widen ( const char * beg, const char * end, CharT * dst ) const ;
(2)
protected :
virtual CharT do_widen ( char c ) const ;
(3)
protected :
virtual const char * do_widen ( const char * beg, const char * end, CharT * dst ) const ;
(4)
1,2) 公开成员函数，调用最终派生类对应的受保护虚成员函数 do_widen 重载。重载 (1) 调用 do_widen ( c ) ，重载 (2) 调用 do_widen ( beg, end, dst ) 。
3) 将单字节字符 c 转换为对应的宽字符表示，使用最简单合理的转换方式。通常这仅适用于多字节编码为单字节的字符（例如 UTF-8 中的 U+0000-U+007F）。
4) 对于字符数组 [ beg , end ) 中的每个字符，将对应的拓宽字符写入到由 dst 指向的字符数组中的连续位置。

扩展操作始终返回宽字符，但只有来自 基本源字符集 (C++23 前) 基本字符集 (C++23 起) 的字符保证具有唯一且明确定义的扩展转换，同时保证该转换可逆（通过 narrow() ）。实际上，所有多字节表示为单字节的字符通常会被扩展为其对应的宽字符形式，而其余可能的单字节值通常会被映射到相同的占位符值，通常是 CharT ( - 1 ) 。

若扩展成功，将保留所有通过 is() 已知的字符分类类别。

目录

参数

c - 要转换的字符
dflt - 转换失败时生成的默认值
beg - 指向要转换字符数组中首个字符的指针
end - 指向要转换字符数组末尾后一位的指针
dst - 指向待填充字符数组首个元素的指针

返回值

1,3) 宽字符。
2,4) end

示例

运行此代码 
#include <iostream>
#include <locale>
void try_widen(const std::ctype<wchar_t>& f, char c)
{
    wchar_t w = f.widen(c);
    std::cout << "The single-byte character " << +(unsigned char)c
              << " widens to " << +w << '\n';
}
int main()
{
    std::locale::global(std::locale("cs_CZ.iso88592"));
    auto& f = std::use_facet<std::ctype<wchar_t>>(std::locale());
    std::cout << std::hex << std::showbase << "In Czech ISO-8859-2 locale:\n";
    try_widen(f, 'a');
    try_widen(f, '\xdf'); // German letter ß (U+00df) in ISO-8859-2
    try_widen(f, '\xec'); // Czech letter ě (U+011b) in ISO-8859-2
    std::locale::global(std::locale("cs_CZ.utf8"));
    auto& f2 = std::use_facet<std::ctype<wchar_t>>(std::locale());
    std::cout << "In Czech UTF-8 locale:\n";
    try_widen(f2, 'a');
    try_widen(f2, '\xdf'); 
    try_widen(f2, '\xec'); 
}

可能的输出： 

In Czech ISO-8859-2 locale:
The single-byte character 0x61 widens to 0x61
The single-byte character 0xdf widens to 0xdf
The single-byte character 0xec widens to 0x11b
In Czech UTF-8 locale:
The single-byte character 0x61 widens to 0x61
The single-byte character 0xdf widens to 0xffffffff
The single-byte character 0xec widens to 0xffffffff

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

缺陷报告 应用于 发布时的行为 正确行为
LWG 153 C++98 widen 总是调用重载版本 (4) 调用对应的重载版本

参见

调用 do_narrow
(公开成员函数)
扩展字符
( std::basic_ios<CharT,Traits> 的公开成员函数)
若可能则将单字节窄字符扩展为宽字符
(函数)