5. コンストラクタ

最終更新日時:
が更新

履歴 編集

function
<locale>

std::numpunct_byname::コンストラクタ

explicit numpunct_byname(const char* name, size_t refs = 0);   // (1) C++98
explicit numpunct_byname(const string& name, size_t refs = 0); // (2) C++98

概要

名前で指定したロケールの、数値の区切り文字に関する情報ファセットオブジェクトを構築する。

  • (1) : ロケール名をconst char*で受け取る
  • (2) : ロケール名をstringで受け取る

効果

  • (1) : nameを名前としてlocale(const char*)で構築されるロケールの、numpunctファセットと等価な仮想関数の意味論を持つよう構築する。refsは基底クラスのコンストラクタへ渡される
  • (2) : numpunct_byname(name.c_str(), refs)と同じ効果を持つ

例外

nameが妥当なロケール名でない場合、もしくはヌルポインタである場合、std::runtime_errorを送出する。

備考

refsは、このファセットの参照カウントの初期値である。

  • refs == 0の場合、このファセットを保持するlocaleオブジェクトが破棄されるとき、ファセットも破棄される
  • refs == 1の場合、localeオブジェクトの破棄によってファセットが破棄されることはない

妥当なロケール名は処理系定義である。"C"と、処理系のネイティブロケールを表す空文字列""は、すべての処理系でサポートされる。

例

#include <iostream>
#include <locale>

int main()
{
  // ファセットのデストラクタはprotectedであるため、
  // newで確保してlocaleに所有権を渡す
  std::locale a{std::locale::classic(), new std::numpunct_byname<char>{"C"}};

  // 同じ名前で構築したロケール
  std::locale b{"C"};

  const auto& fa = std::use_facet<std::numpunct<char>>(a);
  const auto& fb = std::use_facet<std::numpunct<char>>(b);

  // bynameファセットは、同じ名前で構築したロケールのファセットと同じ意味論を持つ
  std::cout << std::boolalpha
            << (fa.decimal_point() == fb.decimal_point()) << std::endl;
}

出力

true

バージョン

言語

  • C++98

関連項目