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

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

本地化库

本地环境与平面
本地环境
locale
use_facet	has_facet
平面类别基类
ctype_base codecvt_base messages_base	time_base money_base
ctype（字符类别）平面
ctype ctype_byname ctype<char>	codecvt codecvt_byname
numeric（数值）平面
num_get num_put	numpunct numpunct_byname
collate（对照比较）平面
collate	collate_byname
time（时间）平面
time_get time_get_byname	time_put time_put_byname
monetary（货币）平面
money_get money_put	moneypunct moneypunct_byname
messages（消息）平面
messages	messages_byname
字符分类与转换
字符分类
isspace isblank (C++11) iscntrl isupper islower isalpha	isdigit ispunct isxdigit isalnum isprint isgraph
转换
toupper tolower	wstring_convert (C++11) wbuffer_convert (C++11)
编码转换平面
codecvt_utf8 (C++11) codecvt_utf16 (C++11)	codecvt_utf8_utf16 (C++11) codecvt_mode (C++11)
C 本地环境
LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	setlocale localeconv lconv

 

std::wbuffer_convert

成员函数

wbuffer_convert::wbuffer_convert

wbuffer_convert::~wbuffer_convert

wbuffer_convert::rdbuf

wbuffer_convert::state

 

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 起)

1) 默认构造函数。

2) 以指定的底层字节流、指定的 codecvt 平面和指定的初始转换状态构造 wbuffer_convert 对象（所有参数均为可选）。

3) 复制构造函数被删除。 wbuffer_convert 非可复制构造 (CopyConstructible) 。

参数

bytebuf	-	指向作为底层窄字符流作用的 std::streambuf 的指针
pcvt	-	指向独立（不为 locale 所管理）的 std::codecvt 平面的指针。若此指针为空则行为未定义。
state	-	字符转换状态的初始值

缺陷报告

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

缺陷报告	应用于	出版时的行为	正确行为
P0935R0	C++11	默认构造函数曾为 explicit	使之为隐式

示例

运行此代码

#include <iostream>
#include <sstream>
#include <locale>
#include <codecvt>
int main()
{
    // 包装 UTF-8 字符串流于 UCS4 wbuffer_convert 中
    std::stringbuf utf8buf(u8"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 << "Reading from a UTF-8 stringbuf via wbuffer_convert:\n";
    for(wchar_t c; ucsbuf.get(c); )
        std::cout << std::hex << std::showbase << c << '\n';
 
    // 包装具 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 << "Sending UCS4 data to std::cout via wbuffer_convert:\n";
    out << L"z\u00df\u6c34\U0001f34c\n";
}

输出：

Reading from a UTF-8 stringbuf via wbuffer_convert produces
0x7a
0xdf
0x6c34
0x1f34c
Sending UCS4 data to std::cout via wbuffer_convert:
zß水🍌