std::wstring_convert<Codecvt,Elem,Wide_alloc,Byte_alloc>::wstring_convert

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

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

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

文本处理库

本地化库

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

格式化库 (C++20)

空终止序列工具

字节字符串

多字节字符串

宽字符串

初等数值转换

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文本编码识别

text_encoding (C++26)

 

本地化库

本地环境与刻面   本地环境 has_facet use_facet locale 刻面类别基类 ctype_base codecvt_base messages_base time_base money_base ctype（字符类别）刻面 ctype ctype<char> ctype_byname codecvt codecvt_byname numeric（数值）刻面 num_get num_put numpunct numpunct_byname collate（校排）刻面 collate collate_byname time（时间）刻面 time_get time_put time_get_byname time_put_byname

monetary（货币）刻面 money_get money_put moneypunct moneypunct_byname messages（消息）刻面 messages messages_byname 字符分类与转换 字符分类 isspace    iscntrl isupper islower    isalpha ispunct isdigit    isxdigit isalnum isblank (C++11) isprint isgraph 字符转换 toupper    tolower 字符串与流转换 wstring_convert (C++11/17/26*) wbuffer_convert (C++11/17/26*) Unicode 转换刻面 codecvt_utf8 (C++11/17/26*) codecvt_utf16 (C++11/17/26*) codecvt_utf8_utf16 (C++11/17/26*) codecvt_mode (C++11/17/26*) C 库本地环境 LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME    setlocale localeconv lconv

 

std::wstring_convert

成员函数

wstring_convert::wstring_convert

wstring_convert::~wstring_convert

wstring_convert::from_bytes

wstring_convert::to_bytes

wstring_convert::converted

wstring_convert::state

 

wstring_convert() : wstring_convert( new Codecvt ) {}	(1)
explicit wstring_convert( Codecvt* pcvt );	(2)
wstring_convert( Codecvt* pcvt, state_type state );	(3)
	(4)
wstring_convert( const std::wstring_convert& ) = delete;	(5)	(C++14 起)

重载	数据成员
	byte_err_string	wide_err_string	cvtptr	cvtstate	cvtcount
(1)	默认初始化		new Codecvt	默认初始化	未初始化
(2)			pcvt
(3)				state
(4)	byte_err	wide_err	new Codecvt	state_type()

2,3) 如果 pcvt 是空指针，那么行为未定义。

5) 复制构造函数被弃置，wstring_convert 不可复制构造 (CopyConstructible) 。

参数

pcvt	-	指向转换刻面的指针
state	-	转换迁移状态的初始值
byte_err	-	错误时显示的窄字符串
wide_err	-	错误时显示的宽字符串

示例

运行此代码

#include <codecvt>
#include <locale>
#include <utility>
 
// 为 wstring/wbuffer 的转换适配绑定本地环境的刻面的工具包装器
template<class Facet>
struct deletable_facet : Facet
{
    using Facet::Facet; // 继承构造函数
    ~deletable_facet() {}
};
 
int main()
{
    // UTF-16le / UCS4 转换
    std::wstring_convert
        <std::codecvt_utf16<char32_t, 0x10ffff, std::little_endian>> u16to32;
 
    // UTF-8 / 宽字符串转换，带定制消息
    std::wstring_convert<std::codecvt_utf8<wchar_t>> u8towide("Error!", L"Error!");
 
    // GB18030 / 宽字符串转换平面
    using F = deletable_facet<std::codecvt_byname<wchar_t, char, std::mbstate_t>>;
    std::wstring_convert<F> gbtowide(new F("zh_CN.gb18030"));
}

缺陷报告

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

缺陷报告	应用于	出版时的行为	正确行为
LWG 2175	C++11	pcvt 可以是空指针	此时行为未定义
LWG 2176	C++11	构造函数是隐式的	改成显式的
P0935R0	C++11	默认构造函数是显式的	改成隐式的