std::put_money

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Ein-/Ausgabe-Bibliothek

I/O-Manipulatoren

Print-Funktionen (C++23)

C-Style I/O

Puffer

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

Streams

Abstraktionen

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

Datei-I/O

basic_ifstream

basic_ofstream

basic_fstream

String-I/O

basic_istringstream

basic_ostringstream

basic_stringstream

Array-I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

Synchronisierte Ausgabe

basic_osyncstream (C++20)

Typen

streamoff

streamsize

fpos

Fehlerkategorie-Schnittstelle

iostream_category (C++11)

io_errc (C++11)

 

Input/output-Manipulatoren

Formatierung von Gleitkommazahlen
showpointnoshowpoint setprecision	fixedscientifichexfloatdefaultfloat (C++11)(C++11)
Ganzzahlformatierung
setbase showbasenoshowbase	dechexoct
Boolean-Formatierung
boolalphanoboolalpha
Feldbreiten- und Füllzeichensteuerung
setfill setw	internalleftright
Andere Formatierungen
showposnoshowpos	uppercasenouppercase
Leerzeichenverarbeitung
ws ends	skipwsnoskipws
Ausgabe-Flushen
flush endl flush_emit (C++20)	unitbufnounitbuf emit_on_flushnoemit_on_flush (C++20)(C++20)
Statusflags-Manipulation
resetiosflags	setiosflags
Zeit- und Geld-I/O
get_money (C++11) get_time (C++11)	put_money (C++11) put_time (C++11)
Gequoteter Manipulator
quoted (C++14)

 

Definiert im Header <iomanip>
template< class MoneyT > /*nicht spezifiziert*/ put_money( const MoneyT& mon, bool intl = false );		(seit C++11)

Bei Verwendung in einem Ausdruck out << put_money(mon, intl), konvertiert den monetären Wert mon in seine Zeichenrepräsentation, wie durch die std::money_put Facette des für out aktuell eingebundenen Locales angegeben.

Die Einfügeoperation in out << put_money(mon, intl) verhält sich wie eine FormattedOutputFunction.

Parameter

mon	-	ein monetärer Wert, entweder long double oder std::basic_string
intl	-	verwendet internationale Währungszeichen, wenn true, andernfalls Währungssymbole

Rückgabewert

Ein Objekt eines nicht spezifizierten Typs, so dass

• Wenn out ein Objekt vom Typ std::basic_ostream<CharT, Traits> ist, verhält sich der Ausdruck out << put_money(mon, intl)
  • vom Typ std::basic_ostream<CharT, Traits>& ist
  • hat den Wert out
  • wie eine FormattedOutputFunction, die f(out, mon, intl) aufruft.

wobei die Funktion f definiert ist als

template<class CharT, class Traits, class MoneyT>
void f(std::basic_ios<CharT, Traits>& str, const MoneyT& mon, bool intl)
{
    using Iter = std::ostreambuf_iterator<CharT, Traits>;
    using MoneyPut = std::money_put<CharT, Iter>;
 
    const MoneyPut& mp = std::use_facet<MoneyPut>(str.getloc());
    const Iter end = mp.put(Iter(str.rdbuf()), intl, str, str.fill(), mon);
 
    if (end.failed())
        str.setstate(std::ios_base::badbit);
}

Beispiel

Führen Sie diesen Code aus

#include <iomanip>
#include <iostream>
 
int main()
{
    long double mon = 123.45; // or std::string mon = "123.45";
 
    std::cout.imbue(std::locale("en_US.UTF-8"));
    std::cout << std::showbase
              << "en_US: " << std::put_money(mon)
              << " or " << std::put_money(mon, true) << '\n';
 
    std::cout.imbue(std::locale("ru_RU.UTF-8"));
    std::cout << "ru_RU: " << std::put_money(mon)
              << " or " << std::put_money(mon, true) << '\n';
 
    std::cout.imbue(std::locale("ja_JP.UTF-8"));
    std::cout << "ja_JP: " << std::put_money(mon)
              << " or " << std::put_money(mon, true) << '\n';
}

Mögliche Ausgabe

en_US: $1.23 or USD  1.23
ru_RU: 1.23 руб or 1.23 RUB 
ja_JP: ￥123 or JPY  123

Siehe auch

money_put	formatiert einen Geldbetrag für die Ausgabe als Zeichensequenz (Klassentemplate)
get_money (C++11)	Parst einen Geldbetrag (Funktion-Template)