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

< cpp‎ | locale‎ | messages
 
C++
 
本地化库
 
std::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) 公开成员函数，调用最终导出类的受保护虚成员函数 do_open 。

2) 获得 catalog 类型（继承自 std::messages_base ）值，能将它传递给 get() 以从 name 所指名的消息目录取得消息。此值可使用直至传递给 close() 为止。

参数

name - 要打开的消息目录名称
loc - 提供可能为从目录读取消息所要求的额外平面，例如用以进行宽/多字节转换的 std::codecvt 的 locale 对象

返回值

能传递给 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

参阅