std::wbuffer_convert<Codecvt,Elem,Tr>::wbuffer_convert

来自cppreference.com
 
C++
 
文本处理库
 
本地化库
 
std::wbuffer_convert
 
wbuffer_convert() : wbuffer_convert(nullptr) {}
(1)
explicit wbuffer_convert( std::streambuf* bytebuf,

                          Codecvt* pcvt = new Codecvt,

                          state_type state = state_type() );
(2)
wbuffer_convert( const std::wbuffer_convert& ) = delete;
(3)(C++14 起)
  重载  数据成员
bufptrcvtptrcvtstate
(1) nullptr  new Codecvt  state_type() 
(2)bytebufpcvtstate
2) 如果 cvtptr 是空指针，那么行为未定义。
3) 复制构造函数被弃置。wbuffer_convert 非可复制构造。

参数

bytebuf-指向底层缓冲区的指针
pcvt-指向独立（不为本地环境所管理）刻面的指针
state-字符转换状态的初始值

示例

运行此代码
#include <codecvt>
#include <iostream>
#include <locale>
#include <sstream>
 
int main()
{
    // 包装 UTF-8 字符串流于 UCS4 wbuffer_convert 中
    std::stringbuf utf8buf("z\u00df\u6c34\U0001f34c");  // 或 u8"zß水🍌"
                       // 或 "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9f\x8d\x8c";
    std::wbuffer_convert<std::codecvt_utf8<wchar_t>> conv_in(&utf8buf);
    std::wistream ucsbuf(&conv_in);
    std::cout << "通过 wbuffer_convert 从 UTF-8 stringbuf 读取：";
              << std::hex << std::showbase;
    for (wchar_t c; ucsbuf.get(c);)
        std::cout << static_cast<std::wint_t>(c) << ' ';
 
    // 包装具 UTF-8 的 std::cout 于 UCS4 wbuffer_convert 中以输出 UCS4
    std::wbuffer_convert<std::codecvt_utf8<wchar_t>> conv_out(std::cout.rdbuf());
    std::wostream out(&conv_out);
    std::cout << "\n通过 wbuffer_convert 向 std::cout 发送 UCS4 数据：";
    out << L"z\u00df\u6c34\U0001f34c\n";
}

输出：

通过 wbuffer_convert 从 UTF-8 stringbuf 读取：0x7a 0xdf 0x6c34 0x1f34c 
通过 wbuffer_convert 向 std::cout 发送 UCS4 数据：zß水🍌

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告应用于出版时的行为正确行为
LWG 2175C++11pcvt 可以是空指针此时行为未定义
LWG 2176C++11构造函数是隐式的改成显式的
P0935R0C++11默认构造函数是显式的改成隐式的
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/locale/wbuffer_convert/wbuffer_convert&oldid=95210”