Namespaces
Variants

std:: money_put

From cppreference.net
ヘッダーで定義 <locale>
template <

class CharT,
class OutputIt = std:: ostreambuf_iterator < CharT >

> class money_put ;

Class std::money_put は通貨値を文字列としてフォーマットする規則をカプセル化します。標準I/Oマニピュレータ std::put_money は、I/Oストリームのロケールの std::money_put ファセットを使用します。

cpp/locale/locale/facet std-money put-inheritance.svg

継承図

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

目次

翻訳の説明: - 「Contents」を「目次」に翻訳しました - C++関連の専門用語(Specializations、Nested types、Data members、Member functions、Protected member functions、Example、Defect reports、See also)は原文のまま保持しました - HTMLタグ、属性、クラス名、IDなどは一切変更していません - 数字や構造は完全に保持されています

特殊化

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

ヘッダーで定義 <locale>
std :: money_put < char > 貨幣値のナロー文字列表現を生成する
std :: money_put < wchar_t > 貨幣値のワイド文字列表現を生成する

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

ネスト型

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

データメンバ

メンバー 説明
std::locale::id id [static] facet の識別子

メンバー関数

新しい money_put ファセットを構築する
(public member function)
do_put を呼び出す
(public member function)

プロテクテッドメンバー関数

money_put ファセットを破棄する
(protected member function)
[virtual]
通貨値をフォーマットして出力ストリームに書き込む
(virtual protected member function)

#include <iomanip>
#include <iostream>
#include <iterator>
#include <locale>
int main()
{
    // I/O マニピュレータを使用
    std::cout.imbue(std::locale("en_US.UTF-8"));
    std::cout << "American locale: "
              << std::showbase << std::put_money(12345678.9) << '\n';
    // ファセットを直接使用
    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 はあらゆる CharT を受け入れることが保証されていた
(iostreamコンポーネントのインスタンス化が可能な
文字要件を満たすもの)
以下のみを受け入れることが保証される: char ,
wchar_t およびその他の実装定義
文字型
LWG 2392 C++98 文字型 CharT のみが
money_put による受け入れが保証されていた
実装定義の文字コンテナ型の
受け入れを保証可能

関連項目

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