Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
std::put_money(3)	      C++ Standard Libary	     std::put_money(3)

NAME
       std::put_money -	std::put_money

Synopsis
	  Defined in header <iomanip>
	  template<		   class		MoneyT		     >
       (since C++11)
	  /*unspecified*/ put_money( const MoneyT& mon,	bool intl = false );

	  When used in an expression out << put_money(mon, intl), converts the
       monetary	value
	  mon  to  its	character   representation   as	  specified   by   the
       std::money_put facet of the
	  locale currently imbued in out.

	  The insertion	operation in out << put_money(mon, intl) behaves as a
	  FormattedOutputFunction.

Parameters
	  mon  - a monetary value, either long double or std::basic_string
	  intl - use international currency strings if true, use currency sym-
       bols otherwise

Return value
	  Returns  an  object of unspecified type such that if out is the name
       of an output
	  stream of type std::basic_ostream<CharT, Traits>, then  the  expres-
       sion out	<<
	  put_money(mon, intl) behaves as if the following code	was executed:

	  typedef std::ostreambuf_iterator<CharT, Traits> Iter;
	  typedef std::money_put<CharT,	Iter> MoneyPut;
	  const	MoneyPut& mp = std::use_facet<MoneyPut>(out.getloc());
	  const	 Iter  end  = mp.put(Iter(out.rdbuf()),	intl, out, out.fill(),
       mon);
	  if (end.failed())
	  out.setstate(std::ios::badbit);

Example
       // Run this code

	#include <iostream>
	#include <iomanip>

	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';
	}

Possible output:
	en_US: $1.23 or	USD  1.23
	ru_RU: 1.23  or	1.23 RUB
	ja_JP: 123 or JPY  123

See also
	  money_put formats a monetary value for output	 as  a	character  se-
       quence
		    (class template)
	  get_money parses a monetary value
	  (C++11)   (function template)

http://cppreference.com		  2022.07.31		     std::put_money(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::put_money&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help