Namespaces
Variants

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

From cppreference.net
C++
Text processing library
Localization library
std::messages
定義済みヘッダー <locale>
public :
catalog open ( const std:: string & name, const std:: locale & loc ) const ;
(1)
protected :
virtual catalog do_open ( const std:: string & name, const std:: locale & loc ) const ;
(2)
1) パブリックメンバー関数。最も派生したクラスの保護された仮想メンバー関数 do_open を呼び出す。
2) catalog 型の値を取得します（ std::messages_base から継承）。この値は get() に渡して name で指定されたメッセージカタログからメッセージを取得するために使用できます。この値は close() に渡されるまで使用可能です。

目次

パラメータ

name - オープンするメッセージカタログの名前
loc - カタログからのメッセージ読み取りに必要な追加ファセット（ワイド/マルチバイト変換を行う std::codecvt など）を提供するロケールオブジェクト

戻り値

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

注記

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

関連項目