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

< cpp‎ | locale‎ | wstring convert

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"));
    }