std::money_put

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

継承図

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

CharT は以下のいずれかです。
- char,
- wchar_t、および
- 実装定義の文字コンテナ型で、iostream コンポーネントをインスタンス化できる文字の要件を満たすもの。
OutputIt は LegacyOutputIterator の要件を満たさなければなりません。

[編集] ネストされた型

型	定義
`char_type`	`CharT`
`string_type`	std::basic_string<CharT>
`iter_type`	`OutputIt`

[編集] データメンバ

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

[編集] メンバ関数

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

[編集] 保護されたメンバ関数

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

[編集] 例

このコードを実行

#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 コンポーネントをインスタンス化できる文字の要件を満たす	`char`、 wchar_t、およびその他の実装定義の文字型のみを受け入れることが保証されています。
LWG 2392	C++98	`num_put` が受け入れることが保証できるのは、 `money_put` で受け入れられることが保証される、任意の `CharT` を受け入れることが保証されていました。	実装定義の文字コンテナ型を受け入れることを保証できます。

[編集] 関連情報

moneypunct	std::money_get および std::money_put によって使用される通貨フォーマットパラメータを定義します。 (クラステンプレート) [編集]
money_get	入力文字列シーケンスから通貨値を解析・構築する (クラステンプレート) [編集]
put_money (C++11)	通貨の値をフォーマットして出力する (関数テンプレート) [編集]

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

メンバ関数
money_put::money_put
money_put::~money_put
money_put::putmoney_put::do_put

ヘッダー `<locale>` で定義
std::money_put<char>	通貨値のナローストリング表現を作成します。
std::money_put<wchar_t>	通貨値のワイドストリング表現を作成します。

cppreference.com

名前空間

変種

表示

操作