std::messages_byname

namespace std {
  template <class charT>
  class messages_byname : public messages<charT>;
}

概要

messages_bynameは、名前で指定したロケールの翻訳メッセージの取得を提供する、messagesの派生クラスである。

messagesの仮想関数を、locale(const char*)で同じ名前を指定して構築したロケールのファセットと等価な意味論で実装する。

このクラスはmessagesが提供するインタフェースをそのまま継承しており、独自のメンバ関数は持たない。

メンバ関数

publicメンバ関数

protectedメンバ関数

メンバ型

例

メッセージカタログの形式と探索方法は処理系定義である。以下は、POSIXのcatgets形式のカタログを使用する処理系での例である。

日本語のメッセージのソースファイルja.msgを、

$set 1
1 こんにちは、世界！

POSIXのgencatコマンドでカタログファイルja.catへ変換したものが存在するとする。

gencat ja.cat ja.msg

#include <iostream>
#include <locale>

int main()
{
  // メッセージのカテゴリだけを"ja_JP.UTF-8"ロケールのものにし、
  // 数値の書式などその他のカテゴリはCロケールのままにする
  std::locale loc{std::locale::classic(), new std::messages_byname<char>{"ja_JP.UTF-8"}};

  const auto& msgs = std::use_facet<std::messages<char>>(loc);

  std::messages_base::catalog cat = msgs.open("./ja.cat", loc);

  if (cat >= 0) {
    // 日本語のメッセージが取得できる
    std::cout << msgs.get(cat, 1, 1, "Hello, world!") << std::endl;
    msgs.close(cat);
  }

  // 数値の小数点はCロケールのまま
  std::cout << std::use_facet<std::numpunct<char>>(loc).decimal_point() << std::endl;
}

出力例

こんにちは、世界！
.

• messages_bynameを使うと、グローバルロケールを変更することなく、メッセージのカテゴリだけを特定の名前のロケールのものに固定できる
• カタログ名からカタログへの対応付けは処理系定義である。GNU gettextを使用する処理系では、open()にドメイン名を渡すことで、ロケール名に対応するカタログが選択される
• 妥当なロケール名は処理系定義である。指定した名前が妥当でない場合、コンストラクタはstd::runtime_errorを送出する

バージョン

言語

• C++98

関連項目

• messages
• locale