std::wstring_convert<Codecvt,Elem,Wide_alloc,Byte_alloc>:: to_bytes
|
Определено в заголовке
<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) | |
Преобразует широкую последовательность в байтовую строку с использованием фасета, на который указывает
cvtptr
.
[
first
,
last
)
.
Перед началом преобразования, если
*
this
был
не
сконструирован с использованием перегрузки конструктора
(3)
,
cvtstate
будет установлен в значение по умолчанию (начальное состояние преобразования).
Количество успешно преобразованных входных элементов будет сохранено в
cvtcount
.
Содержание |
Возвращаемое значение
Если преобразование завершается успешно, возвращает результат преобразования. В противном случае, если
*
this
создан с использованием перегрузки конструктора
(4)
, возвращает
byte_err_string
.
Исключения
Если преобразование завершается неудачей и * this был не сконструирован с использованием перегрузки конструктора (4) , выбрасывается std::range_error .
Пример
#include <codecvt> #include <iomanip> #include <iostream> #include <locale> #include <string> // 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\U0001f34c"; // 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 9f 8d 8c UTF-16le conversion produced 10 bytes: 7a 00 df 00 34 6c 3c d8 4c df
Смотрите также
|
преобразует байтовую строку в широкую строку
(публичная функция-член) |
|
|
преобразует широкую строку в узкую многобайтовую строку с учётом состояния
(функция) |
|
|
[virtual]
|
преобразует строку из
InternT
в
ExternT
, например при записи в файл
(виртуальная защищённая функция-член
std::codecvt<InternT,ExternT,StateT>
)
|