最終更新日時(UTC): 2025年05月23日 01時33分50秒
Akira Takahashi が更新

履歴 編集

function
<locale>

# std::wstring_convert::コンストラクタ(C++11)(C++17で非推奨)(C++26で削除)

    wstring_convert(Codecvt* pcvt = new Codecvt);          // (1) C++11
    explicit wstring_convert(Codecvt* pcvt = new Codecvt); // (1) C++14
    wstring_convert() : wstring_convert(new Codecvt) {}    // (1) C++20

    explicit wstring_convert(Codecvt* pcvt);               // (2) C++14

    wstring_convert(Codecvt* pcvt, state_type state);      // (3) C++11

    wstring_convert(
        const byte_string& byte_err,
        const wide_string& wide_err = wide_string());      // (4) C++11
    explicit wstring_convert(
        const byte_string& byte_err,
        const wide_string& wide_err = wide_string());      // (4) C++14

    wstring_convert(const wstring_convert&) = delete;      // (5) C++14

このクラスはC++17から非推奨となり、C++26で削除された。

## 概要

- (1) : デフォルトコンストラクタ。
- (2) : コード変換機を受け取るコンストラクタ。
- (3) : コード変換機、および変換状態を受け取るコンストラクタ。
- (4) : 変換に失敗した際に返す文字列を受け取るコンストラクタ。
- (5) : コピーコンストラクタ。コピー不可。これによりムーブも不可。

## 要件

- (2), (3) : `pcvt != nullptr`であること。

## 効果

- (2) : コード変換機のインスタンス`pcvt`をメンバ変数として保持し、`from_bytes()`および`to_bytes()`関数でのコード変換に使用する。
  - `from_bytes()`メンバ関数での変換失敗時に返されるワイド文字列は未設定となる。
  - `to_bytes()`メンバ関数での変換失敗時に返されるバイト文字列は未設定となる。
  - `state()`メンバ関数で返される状態は、初期状態となる。
- (3) : コード変換機のインスタンス`pcvt`をメンバ変数として保持し、`from_bytes()`および`to_bytes()`関数でのコード変換に使用する。`state()`メンバ関数で返される値として、パラメータ`state`を保持する。
  - `from_bytes()`メンバ関数での変換失敗時に返されるワイド文字列は未設定となる。
  - `to_bytes()`メンバ関数での変換失敗時に返されるバイト文字列は未設定となる。
- (4) : `to_bytes()`メンバ関数での変換失敗時に`byte_err`が返されるようになり、`from_bytes()`メンバ関数での変換失敗時に`wide_err`が返されるようになる。
  - 式`new Codecvt`で生成したコード変換機のインスタンスを、メンバ変数として保持する。
  - `state()`メンバ関数で返される状態は、初期状態となる。

## 例

    #include <iostream>
    #include <string>
    #include <locale>
    #include <codecvt>

    int main()
    {
      using cvt_t = std::codecvt_utf8<char32_t>;
      using converter_t = std::wstring_convert<cvt_t, char32_t>;

      // (1)
      // デフォルトコンストラクタ
      converter_t converter1;

      // (3)
      // コード変換機のインスタンス、および変換状態を受け取るコンストラクタ
      std::mbstate_t state;
      converter_t converter2(new cvt_t(), state);

      // (4)
      // 変換失敗時に返す文字列を受け取るコンストラクタ
      converter_t converter3(u8"convert error", U"convert error");
    }

### 出力

## バージョン

### 言語

- C++11

### 処理系

- Clang: 3.0 ✅, 3.1 ✅, 3.2 ✅, 3.3 ✅, 3.4 ✅
- GCC: 5.1 ✅
- ICC:
- Visual C++: 2010 ✅, 2012 ✅, 2013 ✅

## 参照

- LWG Issue 2175. `wstring_convert` and `wbuffer_convert` validity
- LWG Issue 2176. Special members for `wstring_convert` and `wbuffer_convert`
- P0935R0 Eradicating unnecessarily explicit default constructors from the standard library
- P2872R3 Remove `wstring_convert` From C++26