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

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から非推奨となった。

概要

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

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

概要

要件

効果

例

出力

バージョン

言語

処理系

参照