std::num_put

ヘッダー `<locale>` で定義
template< class CharT, class OutputIt = std::ostreambuf_iterator<CharT> > class num_put;

クラス std::num_put は、数値を文字列としてフォーマットする規則をカプセル化します。具体的には、型 bool, long, unsigned long, long long, unsigned long long(since 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 の要件を満たさなければなりません。

[編集] ネストされた型

型	定義
`char_type`	`CharT`
`iter_type`	`OutputIt`

[編集] データメンバ

メンバ	説明
std::locale::id `id` [static]	ファセットの識別子

[編集] メンバ関数

(コンストラクタ)	新しい `num_put` ファセットを構築します。 (public member function)
put	`do_put` を呼び出します。 (public member function)

[編集] protected メンバ関数

(デストラクタ)	`num_put` ファセットを破棄します。 (protected メンバ関数)
do_put [virtual]	数値をフォーマットし、出力ストリームに書き込みます。 (仮想 protected メンバ関数)

[編集] 例

このコードを実行

#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++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 427	C++98	`num_put` は、以下の条件を満たす任意の `CharT` を受け入れることが保証されていました。 iostream コンポーネントをインスタンス化できる文字の要件を満たす	`char`、 wchar_t、およびその他の実装定義の文字型のみを受け入れることが保証されています。
LWG 2392	C++98	`num_put` が受け入れることが保証できるのは、文字型 `CharT` のみでした。	実装定義の文字コンテナ型を受け入れることを保証できます。

[編集] 関連項目

numpunct	数値の句読点ルールを定義する (クラステンプレート) [編集]
num_get	入力文字列シーケンスから数値を解析する (クラステンプレート) [編集]
to_string (C++11)	整数値または浮動小数点値を `string` に変換する (function) [編集]
to_wstring (C++11)	整数値または浮動小数点値を `wstring` に変換する (function) [編集]

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

メンバ関数
num_put::num_put
num_put::~num_put
num_put::putnum_put::do_put

ヘッダー `<locale>` で定義
std::num_put<char>	数値を狭い文字列表現で生成します。
std::num_put<wchar_t>	数値をワイド文字列表現で生成します。

cppreference.com

名前空間

変種

表示

操作