std::codecvt_byname
来自cppreference.com
 |
该页由英文版wiki使用Google Translate机器翻译而来。
该翻译可能存在错误或用词不当。鼠标停留在文本上可以看到原版本。你可以帮助我们修正错误或改进翻译。参见说明请点击这里. |
| 在头文件 <locale> 中定义
|
||
| template< class internT, class externT, class stateT > class codecvt_byname : public std::codecvt<internT, externT, stateT>; |
||
std::codecvt_byname是一个std::codecvt方面，它封装了多字节/宽字符转换规则，在其建设一个指定的区域.
原文：
std::codecvt_byname is a std::codecvt facet which encapsulates multibyte/wide character conversion rules of a locale specified at its construction.
四个专业所提供的标准库
原文：
Four specializations are provided by the standard library
| 在头文件
<locale> 中定义 | |
| std::codecvt_byname<char, char, std::mbstate_t> | 身份的转换
|
| std::codecvt_byname<char16_t, char, std::mbstate_t> | UTF-16和UTF-8之间的转换（C++11 起）
原文： conversion between UTF-16 and UTF-8 （C++11 起） |
| std::codecvt_byname<char32_t, char, std::mbstate_t> | UTF-32和UTF-8（C++11 起）之间的转换
原文： conversion between UTF-32 and UTF-8 （C++11 起） |
| std::codecvt_byname<wchar_t, char, std::mbstate_t> | 区域设置特定的宽字符串和狭窄的，可能是多字节字符串之间的转换
原文： locale-specific conversion between wide string and narrow, possibly multibyte, string |
目录 |
[编辑] 成员函数
| 构造一个新codecvt_byname方面 原文： constructs a new codecvt_byname facet （公共成员函数） | |
| 解构一个codecvt_byname方面 （受保护的成员函数） | |
Inherited from std::codecvt
Member types
| 会员类型
|
Definition |
intern_type
|
internT
|
extern_type
|
externT
|
state_type
|
stateT
|
Member objects
| 会员名称
|
Type |
id （静态的）
|
std::locale::id |
Member functions
| 调用 do_out （公共成员函数of std::codecvt）
| |
| 调用 do_in （公共成员函数of std::codecvt）
| |
| 调用 do_unshift （公共成员函数of std::codecvt）
| |
| 调用 do_encoding （公共成员函数of std::codecvt）
| |
| 调用 do_always_noconv （公共成员函数of std::codecvt）
| |
| 调用 do_length （公共成员函数of std::codecvt）
| |
| 调用 do_max_length （公共成员函数of std::codecvt）
| |
Protected member functions
| [虚]</div></div>
|
转换成一个字符串，如写入文件时，从Internt的externT 原文： converts a string from internT to externT, such as when writing to file （虚拟保护成员函数of std::codecvt）
|
| [虚]</div></div>
|
将字符串转换，如从文件读取时，从externT到Internt的 原文： converts a string from externT to internT, such as when reading from file （虚拟保护成员函数of std::codecvt）
|
| [虚]</div></div>
|
产生的externT不完全转化为字符序列终止符 原文： generates the termination character sequence of externT characters for incomplete conversion （虚拟保护成员函数of std::codecvt）
|
| [虚]</div></div>
|
返回的externT需要产生一个Internt的字符的字符数，如果不变 原文： returns the number of externT characters necessary to produce one internT character, if constant （虚拟保护成员函数of std::codecvt）
|
| [虚]</div></div>
|
该方面的测试，如果所有有效参数值的标识转换为编码 原文： tests if the facet encodes an identity conversion for all valid argument values （虚拟保护成员函数of std::codecvt）
|
| [虚]</div></div>
|
计算将转换成给定的Internt的缓冲区消耗的externT字符串，该字符串的长度 原文： calculates the length of the externT string that would be consumed by conversion into given internT buffer （虚拟保护成员函数of std::codecvt）
|
| [虚]</div></div>
|
返回的最大数目，可以被转换成一个单一的Internt的字符externT字符 原文： returns the maximum number of externT characters that could be converted into a single internT character （虚拟保护成员函数of std::codecvt）
|
</div>
Inherited from std::codecvt_base
| 会员类型
|
Definition |
| enum result { ok, partial, error, noconv }; | 无作用域的枚举类型
|
| 枚举常量
|
Definition |
ok
|
转换完成，没有错误
原文： conversion was completed with no error |
partial
|
不是所有的源字符被转换了
原文： not all source characters were converted |
error
|
遇到无效的字符
|
noconv
|
没有转换，输入和输出类型是相同的
原文： no conversion required, input and output types are the same |
[编辑] 示例
这个例子演示了读取的GB18030编码的文件，从GB18030-意识到语言环境使用的的codecvt方面
原文：
This example demonstrates reading a GB18030-encoded file using the codecvt facet from a GB18030-aware locale
#include <iostream> #include <fstream> #include <string> #include <locale> int main() { // GB18030 narrow multibyte encoding std::ofstream("text.txt") << "\x7a" // letter 'z', U+007a "\x81\x30\x89\x38" // letter 'ß', U+00df "\xcb\xae" // CJK ideogram '水' (water), U+6c34 "\x94\x32\xbc\x35"; // musical sign '𝄋' (segno), U+1d10b std::wifstream fin("text.txt"); fin.imbue(std::locale(fin.getloc(), new std::codecvt_byname<wchar_t, char, std::mbstate_t>("zh_CN.gb18030"))); for(wchar_t c; fin.get(c); ) std::cout << std::hex << std::showbase << c << '\n'; }
输出：
0x7a 0xdf 0x6c34 0x1d10b
[编辑] 另请参阅
| 之间进行转换的字符编码，包括UTF-8，UTF-16，UTF-32 原文： converts between character encodings, including UTF-8, UTF-16, UTF-32 （类模板） | |
