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 对象还实装这些特化的其自身（本地环境限定）版本。

成员类型

成员类型	定义
char_type	CharT
string_type	std::basic_string<CharT>

 

调用 do_get & 从打开的消息目录获取消息

std::messages<CharT>::get, 
std::messages<CharT>::do_get

public: string_type get( catalog cat, int set, int msgid, const string_type& dfault ) const;	(1)
protected: virtual string_type do_get( catalog cat, int set, int msgid, const string_type& dfault ) const;	(2)

1) 公开成员函数，调用最终导出类的受保护虚成员函数 do_get 。

2) 用值 set 、 msgid 和 dfault ，以实现定义方式从打开的消息目录 cat 获得消息。若目录中找不到期待 消息，则返回 dfault 的副本。

参数

cat	-	从 open() 获得且仍未传递给 close() 的标识符
set	-	实现定义参数， POSIX 中为消息集
msgid	-	实现定义参数， POSIX 中为消息标识
dfault	-	要在目录中查找的字符串（若目录使用字符串查找），亦为失败情况下返回的字符串

返回值

来自目录的消息，或若找不到消息则为 dfault 的副本。

注意

POSIX 系统上，此函数调用通常被翻译为对 catgets() 的调用，并原态传递参数 set 、 msgid 和 dfault 给 catgets() 。 GNU libstdc++ 中，此函数忽略 set 和 msgid ，并简单地在要求的本地环境中调用 GNU gettext(dfault) 。

调用示例 linux

下列代码演示消息取得：典型的 GNU/Linux 上，它从 /usr/share/locale/de/LC_MESSAGES/sed.mo 读取

#include <iostream>
#include <locale>

int main()
{
    std::locale locale("de_DE.utf8");
    std::cout.imbue(locale);
    auto& facet = std::use_facet<std::messages<char>>(locale);
    auto cat = facet.open("sed", locale);
    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 locale("Chinese (Simplified)_China.936");
    std::cout.imbue(locale);
    auto& facet = std::use_facet<std::messages<char>>(locale);
    auto cat = facet.open("sed", locale);
    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