c++11 标准模板（STL）本地化库 - 平面类别（std::messages） - 实现从消息目录获取字符串（二）

本地化库

本地环境设施包含字符分类和字符串校对、数值、货币及日期/时间格式化和分析，以及消息取得的国际化支持。本地环境设置控制流 I/O 、正则表达式库和 C++ 标准库的其他组件的行为。

平面类别

实现从消息目录获取字符串

std::messages

template< class CharT > class messages;

类模板 std::messages 是标准 locale 平面，它封装从消息目录取得字符串，例如 GNU gettext 或 POSIX catgets 所提供者。

消息源是实现定义的。

继承图

标准库提供二个孤立（独立于本地环境）的特化：

定义于头文件 <locale>
std::messages<char>	访问窄字符串消息目录
std::messages<wchar_t>	访问宽字符串消息目录

另外， C++ 程序中的每个 locale 对象还实装这些特化的其自身（本地环境限定）版本。

调用 do_open & 打开具名消息目录

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

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 。

调用示例 linux

#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" << std::endl;
    }
    else
    {
        std::cout << "\"No match\" in German: "
                  << facet.get(cat, 0, 0, "No match") << std::endl
                  << "\"Memory exhausted\" in German: "
                  << facet.get(cat, 0, 0, "Memory exhausted") << std::endl;
    }
    facet.close(cat);

    return 0;
}

输出

"No match" in German: Keine Übereinstimmung
"Memory exhausted" in German: Speicher erschöpft
Press <RETURN> to close this window...

调用示例 windows

#include <iostream>
#include <locale>

int main()
{
    std::locale loc("Chinese (Simplified)_China.936");
    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" << std::endl;
    }
    else
    {
        std::cout << "\"No match\" in German: "
                  << facet.get(cat, 0, 0, "No match") << std::endl
                  << "\"Memory exhausted\" in German: "
                  << facet.get(cat, 0, 0, "Memory exhausted") << std::endl;
    }
    facet.close(cat);

    return 0;
}

输出

Could not open german "sed" message catalog