std::money_put
来自 cppreference.cn
| 定义于头文件 <locale> |
||
| template< class CharT, |
||
类 std::money_put 封装了将货币值格式化为字符串的规则。标准 I/O 操纵符 std::put_money 使用 I/O 流的区域设置的 std::money_put facet。
继承关系图
如果标准库不保证提供 std::money_put 特化版本（见下文），则其 put() 和 do_put() 的行为不保证如规范所描述。
内容 |
[编辑] 特化
标准库保证提供以下特化版本（它们被任何区域设置对象要求实现）
| 定义于头文件
<locale> | |
| std::money_put<char> | 创建货币值的窄字符串表示 |
| std::money_put<wchar_t> | 创建货币值的宽字符串表示 |
此外，标准库也保证提供满足以下类型要求的每个特化版本
-
CharT是以下类型之一- char,
- wchar_t，以及
- 任何其他实现定义的字符容器类型，满足任何iostream 组件可以实例化的字符的要求；并且
-
OutputIt必须满足 LegacyOutputIterator 的要求。
[编辑] 嵌套类型
| 类型 | 定义 |
char_type
|
CharT
|
string_type
|
std::basic_string<CharT> |
iter_type
|
OutputIt
|
[编辑] 数据成员
| 成员 | 描述 |
std::locale::id id [静态] |
facet 的标识符 |
[编辑] 成员函数
构造一个新的 money_put facet(公共成员函数) | |
调用 do_put(公共成员函数) |
[编辑] 受保护成员函数
析构一个 money_put facet(受保护成员函数) | |
| [虚拟] |
格式化货币值并写入输出流 (虚拟受保护成员函数) |
[编辑] 示例
运行此代码
#include <iomanip> #include <iostream> #include <iterator> #include <locale> int main() { // using the I/O manipulator std::cout.imbue(std::locale("en_US.UTF-8")); std::cout << "American locale: " << std::showbase << std::put_money(12345678.9) << '\n'; // using the facet directly std::cout.imbue(std::locale("de_DE.UTF-8")); std::cout << "German locale: "; auto& f = std::use_facet<std::money_put<char>>(std::cout.getloc()); f.put({std::cout}, false, std::cout, std::cout.fill(), 12345678.9); std::cout << '\n'; }
输出
American locale: $123,456.79 German locale: 123.456,79 €
[编辑] 缺陷报告
以下行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。
| DR | 应用于 | 已发布行为 | 正确行为 |
|---|---|---|---|
| LWG 427 | C++98 | money_put 保证接受任何 CharT，它满足字符的要求，iostream 组件可以 在字符上被实例化 |
仅保证接受 char， wchar_t 和其他实现定义的 字符类型 |
| LWG 2392 | C++98 | 只有字符类型 CharT 可以被保证被 money_put 接受 |
可以保证接受实现定义的 字符容器类型 |
[编辑] 参见
| 定义 std::money_get 和 std::money_put 使用的货币格式化参数 (类模板) | |
| 从输入字符序列解析和构造货币值 (类模板) | |
| (C++11) |
格式化和输出货币值 (函数模板) |
