std::money_put<CharT,OutputIt>::put, do_put

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

テキスト処理ライブラリ

ローカライズライブラリ

正規表現ライブラリ (C++11)

フォーマットライブラリ (C++20)

ヌル終端シーケンスユーティリティ

バイト文字列

マルチバイト文字列

ワイド文字列

プリミティブな数値変換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

テキストエンコーディング識別

text_encoding (C++26)

 

ローカライズライブラリ

ロケールとファセット   ロケール has_facet use_facet locale ファセットカテゴリ 基底クラス ctype_base codecvt_base messages_base time_base money_base ctypeファセット ctype ctype<char> ctype_byname codecvt codecvt_byname 数値ファセット num_get num_put numpunct numpunct_byname 文字比較ファセット collate collate_byname 時間ファセット time_get time_put time_get_byname time_put_byname

通貨ファセット money_get money_put moneypunct moneypunct_byname メッセージファセット messages messages_byname 文字の分類と変換 文字の分類 isspace    iscntrl isupper islower    isalpha ispunct isdigit    isxdigit isalnum isblank (C++11) isprint isgraph 文字変換 toupper    tolower 文字列とストリームの変換 wstring_convert (C++11/17/26*) wbuffer_convert (C++11/17/26*) Unicode変換ファセット codecvt_utf8 (C++11/17/26*) codecvt_utf16 (C++11/17/26*) codecvt_utf8_utf16 (C++11/17/26*) codecvt_mode (C++11/17/26*) Cライブラリのロケール LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME    setlocale localeconv lconv

 

std::money_put

メンバ関数

money_put::money_put

money_put::~money_put

money_put::putmoney_put::do_put

 

ヘッダー <locale> で定義
public: iter_type put( iter_type out, bool intl, std::ios_base& f,                char_type fill, long double quant ) const;	(1)
iter_type put( iter_type out, bool intl, std::ios_base& f,                char_type fill, const string_type& quant ) const;	(2)
protected: virtual iter_type do_put( iter_type out, bool intl, std::ios_base& str,                           char_type fill, long double units ) const;	(3)
virtual iter_type do_put( iter_type out, bool intl, std::ios_base& str,                           char_type fill, const string_type& digits ) const;	(4)

通貨の値をフォーマットし、結果を出力ストリームに書き込みます。

1,2) public メンバ関数は、最も派生したクラスのメンバ関数 do_put を呼び出します。

3) 数値引数 units は、ct が str.getloc() に埋め込まれた std::ctype ファセットであり、buf1 および buf2 が十分に大きな文字バッファである場合、ct.widen(buf1, buf1 + std::sprintf(buf1, "%.0Lf", units), buf2) でのように、ct.widen(buf1, buf1 + std::sprintf(buf1, "%.0Lf", units), buf2) としてワイド文字文字列に変換されます。結果の文字列 buf2 は、以下に説明するように処理、フォーマットされ、out に出力されます。

4) 文字列引数 digits から、オプションの先頭のマイナス記号（ct が str.getloc() に埋め込まれた std::ctype ファセットである場合、ct.widen('-') との比較によって決定される）と、それに続く数字文字（ct によって分類される）のみが、以下に説明するように処理、フォーマットされ、out に出力される文字シーケンスとして取得されます。

前のステップからの文字シーケンスが与えられた場合、最初の文字が ct.widen('-') と等しい場合、フォーマット pattern を取得するために mp.neg_format() が呼び出され、それ以外の場合は mp.pos_format() が呼び出されます。ここで、mp は str.getloc() に埋め込まれた std::moneypunct<CharT, intl> ファセットです。

千単位の区切り文字と小数点文字は、mp.grouping()、mp.frac_digits()、mp.decimal_point()、および mp.thousands_sep() によって必要に応じて挿入され、結果の文字列はフォーマットパターンで value が現れる位置に配置されます。

もし str.flags() & str.showbase がゼロでない場合（std::showbase マニピュレータが使用された）、通貨記号または文字列は mp.curr_symbol() を呼び出すことによって生成され、フォーマットパターンで symbol が現れる位置に出力シーケンスに配置されます。

もし mp.positive_sign()（正のフォーマットパターンの場合）または mp.negative_sign()（負のフォーマットパターンの場合）が1文字より長い文字列を返す場合、最初に返された文字はフォーマットパターンで sign が現れる位置に出力シーケンスに配置され、残りの文字は他のすべての文字の後ろに配置されます。例えば、単位が 123 で negative_sign が "-" の場合、フォーマットパターン {sign, value, space, symbol} は "-1.23 €" になる可能性がありますが、negative_sign が "()" の場合は "(1.23 €)" が生成されます。

指定されたフォーマットのために生成された文字数が str.width() によって返される値より小さい場合、出力シーケンスの総長がちょうど str.width() になるように、fill のコピーが挿入されます。挿入方法は以下の通りです。

• もし str.flags() & str.adjustfield が str.internal と等しい場合、フィル文字はフォーマットパターンで none または space が現れる場所に挿入されます。
• そうでなければ、もし str.flags() & str.adjustfield が str.left と等しい場合、fill のコピーは他のすべての文字の後ろに追記されます。
• それ以外の場合、フィル文字は他のすべての文字の前に配置されます。

最後に、str.width(0) を呼び出して、std::setw の効果をキャンセルします。

返り値

生成された最後の文字の直後を指すイテレータ。

注記

通貨単位は、通貨の最小の非小数単位であると想定されます。米国ではセント、日本では円。

例

このコードを実行

#include <iomanip>
#include <iostream>
#include <locale>
 
struct my_punct : std::moneypunct_byname<char, false>
{
    my_punct(const char* name) : moneypunct_byname(name) {}
    string_type do_negative_sign() const { return "()"; }
};
 
int main()
{
    std::locale loc("ru_RU.utf8");
    std::cout.imbue(loc);
    long double units = -123.45;
    std::cout << "In Russian locale, " << units << " prints as " << std::showbase;
 
    // note, the following is equivalent to simply std::put_money(units)
    std::use_facet<std::money_put<char>>(loc).put(
        {std::cout}, false, std::cout, std::cout.fill(), units);
    std::cout << '\n';
 
    std::cout.imbue(std::locale(std::cout.getloc(), new my_punct("ru_RU.utf8")));
    std::cout << "With negative_sign set to \"()\", it prints as ";
    std::use_facet<std::money_put<char>>(loc).put(
        {std::cout}, false, std::cout, std::cout.fill(), units);
    std::cout << '\n';
}

出力

In Russian locale, -123,45 prints as -1.23 руб
With negative_sign set to "()", it prints as (1.23 руб)

不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 328	C++98	"%.01f" だった std::sprintf のためのフォーマット文字列	"%.0Lf" に修正

関連項目

moneypunct	std::money_get と std::money_put で使用される通貨書式設定パラメータを定義する (クラステンプレート)
money_get	入力文字列シーケンスから通貨値を解析・構築する (クラステンプレート)
put_money (C++11)	通貨の値をフォーマットして出力する (関数テンプレート)