std::ctype<CharT>::widen, do_widen
定义于头文件 <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> 的公开成员函数) | |
若可能,则加宽单字节窄字符为宽字符 (函数) |