std::wstring_convert::to_bytes

来自cppreference.com

定义于头文件 <locale>
byte_string to_bytes( Elem wchar );
(1)
byte_string to_bytes( const Elem* wptr );
(2)
byte_string to_bytes( const wide_string& wstr );
(3)
byte_string to_bytes( const Elem* first, const Elem* last);
(4)
执行广泛的多字节转换,用在建设方面提供的codecvt.
原文:
Performs wide to multibyte conversion, using the codecvt facet supplied at construction.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
1)
转换wchar,就好像它是一个字符串的长度1,byte_string
原文:
Converts wchar as if it was a string of length 1, to byte_string
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
2)
将null结尾的宽字符的宽字符序列开始,指向wptr,的byte_string
原文:
Converts the null-terminated wide character sequence beginning at the wide character pointed to by wptr, to byte_string
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
3)
转换的宽字符串strbyte_string的.
原文:
Converts the wide string str to byte_string.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
4)
转换为宽字符序列[first, last)的byte_string
原文:
Converts the wide character sequence [first, last) to byte_string
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
在任何情况下,在开始转换在初始移位状态,,除非非初始状态提供了这wstring_convert构造。转换的字符数和最终值的转换状态都记住了,可访问state()converted()
原文:
In all cases, the conversion begins in initial shift state, unless non-initial starting state was provided to this wstring_convert constructor. The number of characters converted and the final value of the conversion state are remembered and can be accessed with state() and converted()
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

目录

[编辑] 返回值

一个byte_string对象,其中包含的广泛的多字节转换的结果。如果转换失败,有一个用户提供的字节错误这wstring_convert的构造函数提供的字符串,返回该字节的错误字符串.
原文:
A byte_string object containing the results of the wide to multibyte conversion. If the conversion failed and there was a user-supplied byte-error string provided to the constructor of this wstring_convert, returns that byte-error string.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 例外

如果没有用户提供的字节错误字符串构造这个wstring_convert对象,抛出std::range_error转换失败.
原文:
If this wstring_convert object was constructed without a user-supplied byte-error string, throws std::range_error on conversion failure.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 示例

#include <iostream>
#include <string>
#include <locale>
#include <codecvt>
#include <iomanip>
 
// utility function for output
void hex_print(const std::string& s)
{
    std::cout << std::hex << std::setfill('0');
    for(unsigned char c : s)
        std::cout << std::setw(2) << static_cast<int>(c) << ' ';
    std::cout << std::dec << '\n';
}
 
int main()
{
    // wide character data
    std::wstring wstr =  L"z\u00df\u6c34\U0001d10b"; // or L"zß水𝄋"
 
    // wide to UTF-8
    std::wstring_convert<std::codecvt_utf8<wchar_t>> conv1;
    std::string u8str = conv1.to_bytes(wstr);
    std::cout << "UTF-8 conversion produced " << u8str.size() << " bytes:\n";
    hex_print(u8str);
 
    // wide to UTF-16le
    std::wstring_convert<std::codecvt_utf16<wchar_t, 0x10ffff, std::little_endian>> conv2;
    std::string u16str = conv2.to_bytes(wstr);
    std::cout << "UTF-16le conversion produced " << u16str.size() << " bytes:\n";
    hex_print(u16str);
}

输出:

UTF-8 conversion produced 10 bytes:
7a c3 9f e6 b0 b4 f0 9d 84 8b 
UTF-16le conversion produced 10 bytes:
7a 00 df 00 34 6c 34 d8 0b dd

[编辑] 另请参阅

转换字节字符串为宽字符串
(公开成员函数) [编辑]
给定状态,转换宽字符串为窄多字节字符串
(函数) [编辑]
[虚]
从 internT 转换字符串为 externT 转换字符串,如在写入文件时
(std::codecvt 的虚受保护成员函数) [编辑]