5. コンストラクタ

最終更新日時:
が更新

履歴 編集

function
<locale>

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

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

概要

名前で指定したロケールの、日時の出力ファセットオブジェクトを構築する。

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

効果

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

例外

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

備考

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

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

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

例

#include <iostream>
#include <sstream>
#include <locale>
#include <iterator>
#include <ctime>

std::string format(const std::locale& loc)
{
  std::ostringstream oss;
  oss.imbue(loc);

  std::tm t{};
  t.tm_year = 126; // 2026年

  const auto& facet = std::use_facet<std::time_put<char>>(loc);
  facet.put(std::ostreambuf_iterator<char>{oss}, oss, ' ', &t, 'Y');

  return oss.str();
}

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

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

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

出力

true

バージョン

言語

  • C++98

関連項目