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 ファセットを使用します。

継承図

std::num_put の特殊化が標準ライブラリによって提供されることが保証されていない場合（下記参照）、その put() および do_put() の動作は指定通りに保証されません。

特殊化

標準ライブラリは以下の特殊化を提供することが保証されています（これらは あらゆるロケールオブジェクトで実装が必須 とされています）:

さらに、標準ライブラリは以下の型要件を満たすすべての特殊化を提供することも保証されています：

• 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 << "文字列への直接変換:\n"
              << std::to_string(n) << '\n'
              << "ドイツ語ロケールを使用した出力:\n"
              << std::fixed << n << '\n'
              << "アメリカ英語ロケールを使用した出力:\n";
    // ファセットを直接使用
    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';
}

文字列への直接変換:
1234567.890000
ドイツ語ロケールを使用した出力:
1.234.567,890000
アメリカ英語ロケールを使用した出力:
1,234,567.890000

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目