std::messages<CharT>::open, std::messages<CharT>::do_open
提供: cppreference.com
ヘッダ <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
から読み込みます。
Run this code
#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