std:: num_put

类 std::num_put 封装了将数值格式化为字符串的规则。具体支持以下类型： bool 、 long 、 unsigned long 、 long long 、 unsigned long long (C++11 起) 、 double 、 long double 、 void * ，以及所有可隐式转换为这些类型的类型（如 int 或 float ）。标准格式化输出运算符（例如 cout << n ; ）使用 I/O 流区域设置的 std::num_put facet 来生成数字的文本表示形式。

继承关系图

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

特化

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

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

• CharT 是以下类型之一：
  • char ，
  • wchar_t ，以及
  • 任何其他实现定义的 字符容器类型 ，该类型需满足可在其上实例化任意 iostream组件 的字符要求；且
• OutputIt 必须满足 LegacyOutputIterator 的要求。

嵌套类型

数据成员

成员函数

受保护成员函数

示例

#include <iostream>
#include <iterator>
#include <locale>
#include <string>
int main()
{
    double n = 1234567.89;
    std::cout.imbue(std::locale("de_DE.UTF-8"));
    std::cout << "Direct conversion to string:\n"
              << std::to_string(n) << '\n'
              << "Output using a german locale:\n"
              << std::fixed << n << '\n'
              << "Output using an american locale:\n";
    // use the facet directly
    std::cout.imbue(std::locale("en_US.UTF-8"));
    auto& f = std::use_facet<std::num_put<char>>(std::cout.getloc());
    f.put(std::ostreambuf_iterator<char>(std::cout), std::cout, ' ', n);
    std::cout << '\n';
}

Direct conversion to string:
1234567.890000
Output using a german locale:
1.234.567,890000
Output using an american locale:
1,234,567.890000

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

参见