Namespaces
Variants

std:: money_put

From cppreference.net
定义于头文件 <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/facet std-money put-inheritance.svg

继承关系图

如果标准库不保证提供某个 std::money_put 特化(参见下文),则其 put() do_put() 成员函数的行为不保证符合规范说明。

目录

特化

标准库保证提供以下特化(它们 是任何locale对象都必须实现的 ):

定义于头文件 <locale>
std :: money_put < char > 生成货币值的窄字符串表示形式
std :: money_put < wchar_t > 生成货币值的宽字符串表示形式

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

嵌套类型

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

数据成员

成员 描述
std::locale::id id [static] facet 的标识符

成员函数

构造新的 money_put facet
(公开成员函数)
调用 do_put
(公开成员函数)

受保护成员函数

销毁 money_put facet
(受保护成员函数)
[virtual]
格式化货币值并写入输出流
(虚受保护成员函数)

示例

#include <iomanip>
#include <iostream>
#include <iterator>
#include <locale>
int main()
{
    // 使用I/O操纵符
    std::cout.imbue(std::locale("en_US.UTF-8"));
    std::cout << "American locale: "
              << std::showbase << std::put_money(12345678.9) << '\n';
    // 直接使用facet
    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++标准。

缺陷报告 适用标准 发布时行为 正确行为
LWG 427 C++98 money_put 被保证接受任何满足
iostream组件实例化要求的字符类型 CharT
仅保证接受 char ,
wchar_t 及其他实现
定义的字符类型
LWG 2392 C++98 仅字符类型 CharT 可被
保证被 money_put 接受
可保证接受实现
定义的字符容器类型

参见

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