std::wstring_convert<Codecvt,Elem,Wide_alloc,Byte_alloc>::from_bytes
来自 cppreference.com
< cpp | locale | wstring convert
| 定义在头文件 <locale> 中 |
||
| wide_string from_bytes( char byte ); |
(1) | |
| wide_string from_bytes( const char* ptr ); |
(2) | |
| wide_string from_bytes( const byte_string& str ); |
(3) | |
| wide_string from_bytes( const char* first, const char* last ); |
(4) | |
使用 cvtptr 指向的面，将字节序列转换为宽字符串。
1) 字节序列仅包含一个元素 byte.
2) 字节序列是从 ptr 开始的以 null 结尾的序列。
3) 字节序列是 str 中包含的序列。
4) 字节序列是范围
[first, last)。在转换开始之前，如果 *this 没有使用构造函数重载 (3) 构造，则 cvtstate 将设置为其默认值（初始转换状态）。
成功转换的输入元素数量将存储在 cvtcount 中。
内容 |
[编辑] 返回值
如果转换成功，则返回转换结果。否则，如果 *this 使用构造函数重载 (4) 构造，则返回 wide_err_string.
[编辑] 异常
如果转换失败且 *this 没有使用构造函数重载 (4) 构造，则抛出 std::range_error.
[编辑] 示例
运行此代码
#include <codecvt> #include <cstdint> #include <iostream> #include <locale> #include <string> int main() { std::string utf8 = "z\u00df\u6c34\U0001d10b"; // or u8"zß水𝄋" // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b"; // the UTF-8 / UTF-16 standard conversion facet std::u16string utf16 = std::wstring_convert<std::codecvt_utf8_utf16<char16_t>, char16_t>{}.from_bytes(utf8.data()); std::cout << "UTF-16 conversion produced " << utf16.size() << " code units: " << std::showbase; for (char16_t c : utf16) std::cout << std::hex << static_cast<std::uint16_t>(c) << ' '; // the UTF-8 / UTF-32 standard conversion facet std::u32string utf32 = std::wstring_convert<std::codecvt_utf8<char32_t>, char32_t>{}.from_bytes(utf8); std::cout << "\nUTF-32 conversion produced " << std::dec << utf32.size() << " code units: "; for (char32_t c : utf32) std::cout << std::hex << static_cast<std::uint32_t>(c) << ' '; std::cout << '\n'; }
输出
UTF-16 conversion produced 5 code units: 0x7a 0xdf 0x6c34 0xd834 0xdd0b UTF-32 conversion produced 4 code units: 0x7a 0xdf 0x6c34 0x1d10b
[编辑] 另请参阅
| 将宽字符串转换为字节字符串 (公共成员函数) | |
| 将窄多字节字符字符串转换为宽字符串，给出状态 (函数) | |
| [虚拟] |
将字符串从 ExternT 转换为 InternT，例如在从文件读取时( std::codecvt<InternT,ExternT,StateT> 的虚拟受保护成员函数) |
