命名空间
变体
操作

std::money_put

来自 cppreference.com
< cpp‎ | locale
 
 
 
 
定义在头文件 <locale>
template<

    class CharT,
    class OutputIt = std::ostreambuf_iterator<CharT>

> class money_put;

std::money_put 封装了将货币值格式化为字符串的规则。标准 I/O 操纵器 std::put_money 使用 I/O 流区域设置的 std::money_put 方面。

cpp/locale/locale/facetstd-money put-inheritance.svg

继承图

如果标准库不保证提供 std::money_put 特化(见下文),则其 put()do_put() 的行为不保证与指定的一致。

内容

[编辑] 特化

标准库保证提供以下特化(它们是 任何区域设置对象都需要实现的)

定义在头文件 <locale>
std::money_put<char> 创建货币值的窄字符串表示
std::money_put<wchar_t> 创建货币值的宽字符串表示

此外,标准库还保证提供满足以下类型要求的每个特化

[编辑] 成员类型

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

[编辑] 成员函数

构造一个新的 money_put 方面
(公有成员函数)
调用 do_put
(公有成员函数)

[编辑] 受保护成员函数

析构一个 money_put 方面
(受保护成员函数)
[虚拟]
格式化货币值并写入输出流
(虚拟受保护成员函数) [编辑]

[编辑] 成员对象

static std::locale::id id
id 的区域设置
(公有成员对象)

[编辑] 示例

#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 保证接受任何满足
可以实例化任何 iostream 组件的字符要求的
CharT
只保证接受 char,
wchar_t 和其他实现-
定义的字符类型
LWG 2392 C++98 只有字符类型 CharT 才能
保证被 money_put 接受
可以保证接受实现-
定义的字符容器类型

[编辑] 另请参见

定义了 std::money_getstd::money_put 使用的货币格式参数
(类模板) [编辑]
解析并从输入字符序列构造货币值
(类模板) [编辑]
(C++11)
格式化并输出货币值
(函数模板) [编辑]