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

来自cppreference.com
wstring_convert() : wstring_convert( new Codecvt ) { }
(1)
explicit wstring_convert( Codecvt* pcvt );
(2)
wstring_convert( Codecvt* pcvt, state_type state);
(3)
explicit wstring_convert( const byte_string& byte_err,
                          const wide_string& wide_err = wide_string() );
(4)
wstring_convert(const std::wstring_convert&) = delete;
(5) (C++14 起)
1) 默认构造函数。
2) 以指定的转换平面,用初始迁移状态和错误字符串的默认构造值构造 wstring_convert 对象。
3) 以指定的转换平面和指定的初始迁移状态,用默认构造的错误字符串值构造 wstring_convert 对象。
4) 以指定的错误字符串,以 new Codecvt 为转换平面并以 state_type 的默认构造值为初始状态构造 wstring_convert 对象。
5) 复制构造函数被删除, wstring_convert 非可复制构造 (CopyConstructible)

参数

pcvt - 指向 Codecvt 类型转换平面的指针(若此指针为空则行为未定义)
state - 转换迁移状态的初始值
byte_err - 错误时显示的窄字符串
wide_err - 错误时显示的宽字符串

缺陷报告

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

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

示例

#include <locale>
#include <utility>
#include <codecvt>
 
// 为 wstring/wbuffer convert 适配绑定本地环境的平面的工具包装器
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 / 宽字符串转换平面
    typedef deletable_facet<std::codecvt_byname<wchar_t, char, std::mbstate_t>> F;
    std::wstring_convert<F> gbtowide(new F("zh_CN.gb18030"));
}