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

< 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) 公开成员函数，调用最终导出类的受保护虚成员函数 `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

### 参阅