本地化库
本地环境设施包含字符分类和字符串校对、数值、货币及日期/时间格式化和分析,以及消息取得的国际化支持。本地环境设置控制流 I/O 、正则表达式库和 C++ 标准库的其他组件的行为。
平面类别
实现从消息目录获取字符串
std::messages
template< class CharT > |
类模板 std::messages 是标准 locale 平面,它封装从消息目录取得字符串,例如 GNU gettext 或 POSIX catgets 所提供者。
消息源是实现定义的。
继承图
标准库提供二个孤立(独立于本地环境)的特化:
定义于头文件 | |
std::messages<char> | 访问窄字符串消息目录 |
std::messages<wchar_t> | 访问宽字符串消息目录 |
另外, C++ 程序中的每个 locale 对象还实装这些特化的其自身(本地环境限定)版本。
调用 do_open & 打开具名消息目录
std::messages<CharT>::open,
std::messages<CharT>::do_open
public: | (1) | |
protected: | (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