Formats monetary value and writes the result to output stream.

Given the character sequence from the previous steps, if the first character equalsct.widen('-'), callsmp.neg_format() to obtain the formattingpattern, otherwise callsmp.pos_format(), wheremp is thestd::moneypunct<CharT, intl> facet imbued instr.getloc().

Thousands separator and decimal point characters are inserted as required bymp.grouping(),mp.frac_digits(),mp.decimal_point(), andmp.thousands_sep(), and the resulting string is placed in the output sequence wherevalue appears in the formatting pattern.

Ifstr.flags()& str.showbase is non-zero (thestd::showbase manipulator was used), then the currency symbol or string is generated by callingmp.curr_symbol() and placed in the output sequence wheresymbol appears in the formatting pattern.

Ifmp.positive_sign() (in case positive format pattern is used) ormp.negative_sign() (in case negative format pattern is used) returns a string with more than one character, the first character returned is placed in the output sequence wheresign appears in the formatting pattern, and the rest of the characters are placed after all other characters, for example, formatting pattern{sign, value, space, symbol} with units123 and negative_sign of"-" may result in"-1.23 €", while negative_sign of"()" would generate"(1.23 €)".

If the number of characters generated for the specified format is less than the value returned bystr.width(), then copies offill are inserted to bring the total length of the output sequence to exactlystr.width(), as follows:

• Ifstr.flags()& str.adjustfield equalsstr.internal, the fill characters are inserted wherenone orspace appears in the formatting pattern.
• Otherwise, ifstr.flags()& str.adjustfield equalsstr.left, the copies offill are appended after all other characters.
• Otherwise, the fill characters are placed before all other characters.

In the end, callsstr.width(0) to cancel the effects of anystd::setw.

[edit]Return value

An iterator pointing immediately after the last character produced.

[edit]Notes

The currency units are assumed to be the smallest non-fractional units of the currency: cents in the U.S, yen in Japan.

[edit]Example

#include <iomanip>#include <iostream>#include <locale> struct my_punct:std::moneypunct_byname<char,false>{    my_punct(constchar* name): moneypunct_byname(name){}    string_type do_negative_sign()const{return"()";}}; int main(){std::locale loc("ru_RU.utf8");std::cout.imbue(loc);longdouble 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 руб)

[edit]Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

[edit]See also

• In other languages

• Deutsch
• Español
• Français
• Italiano
• 日本語
• Português
• Русский
• 中文