名前空間
変種
操作

std::messages<CharT>::open, std::messages<CharT>::do_open

提供: cppreference.com
< cpp‎ | locale‎ | messages
 
 
 
 
ヘッダ <locale> で定義
public:
catalog open( const std::basic_string<char>& name, const std::locale& loc ) const;
(1)
protected:
virtual catalog do_open( const std::basic_string<char>& name, const std::locale& loc ) const;
(2)
1) public メンバ関数。 最も派生したクラスの protected virtual メンバ関数 do_open を呼びます。
2) 名前 name のメッセージカタログからメッセージを取得するために get() に渡すことができる、 (std::messages_base から継承した) catalog 型の値を取得します。 この値は close() に渡されるまで使用可能です。

目次

[編集] 引数

name - 開くメッセージカタログの名前
loc - カタログからメッセージを読み込むために必要かもしれない追加のファセット (ワイド/マルチバイト変換を行うための std::codecvt など) を提供するロケールオブジェクト

[編集] 戻り値

get()close() で使用できる catalog 型の非負の値。 カタログを開けなかった場合は負の値を返します。

[編集] ノート

POSIX システムでは、この関数は通常 catopen() の呼び出しに変換されます。 GNU libstdc++ では、これは textdomain を呼びます。

実際のカタログの位置は処理系定義です。 例えば、ドイツ語ロケールのカタログ "sed" (Unix のユーティリティ 'sed' と共にインストールされるメッセージカタログ) の場合、この関数呼び出しによって開かれるファイルは /usr/lib/nls/msg/de_DE/sed.cat/usr/lib/locale/de_DE/LC_MESSAGES/sed.cat、あるいは /usr/share/locale/de/LC_MESSAGES/sed.mo かもしれません。

[編集]

以下の例はメッセージの取得をデモンストレーションします。 一般的な GNU/Linux システムでは /usr/share/locale/de/LC_MESSAGES/sed.mo から読み込みます。

#include <iostream>
#include <locale>
 
int main()
{
    std::locale loc("de_DE.utf8");
    std::cout.imbue(loc);
    auto& facet = std::use_facet<std::messages<char>>(loc);
    auto cat = facet.open("sed", loc);
    if(cat < 0 )
        std::cout << "Could not open german \"sed\" message catalog\n";
    else
        std::cout << "\"No match\" in German: "
                  << facet.get(cat, 0, 0, "No match") << '\n'
                  << "\"Memory exhausted\" in German: "
                  << facet.get(cat, 0, 0, "Memory exhausted") << '\n';
    facet.close(cat);
}

出力例:

"No match" in German: Keine Übereinstimmung
"Memory exhausted" in German: Speicher erschöpft

[編集] 関連項目