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

来自cppreference.com
< cpp‎ | locale‎ | 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
3) 用最简单的合理变换,转换单字节字符 c 为对应的宽字符。这典型地仅应用于多字节编码为单字节的字符(例如 UTF-8 中的 U+0000-U+007F )。
4) 对字符数组 [beg, end) 中每个字符,写入对应的加宽字符到 dst 所指向的字符数组中的相继位置。

加宽始终返回宽字符,但只保证来自基本源字符集(拉丁字母、数字和要求以书写 C++ 程序的标点)的字符拥有唯一良好定义的加宽变换,它亦保证为可逆(以 narrow() )。实践中,所有多字节表示为单字节的字符通常都被加宽为其宽字符对应,而剩下的可能单字节值通常被映射为同一占位值,典型地为 CharT(-1)

若加宽有意义,则保持 is() 所知的所有字符分类类别。

参数

c - 要转换的字符
dflt - 若转换失败则产生的默认值
beg - 指向要转换的字符数组中首字符的指针
end - 指向要转换的字符数组的尾后一位置的指针
dst - 指向要填充的字符数组首元素的指针

返回值

1,3) 加宽的字符
2,4) end

示例

#include <locale>
#include <iostream>
 
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'); // ISO-8859-2 中的德文字母 ß (U+00df)
    try_widen(f, '\xec'); // ISO-8859-2 中的捷克文字母 ě (U+011b)
 
    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

参阅

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