Spec-Zone.ru › C++

std::put_money

Определён в заголовочном файле <iomanip>
template< class MoneyT >
/*unspecified*/ put_money( const MoneyT& mon, bool intl = false );
(начиная с C++11)

При использовании в выражении out << put_money(mon, intl) преобразует денежное значение mon в его символьное представление, определённое фасетом std::money_put локали, назначенной в данный момент объекту out.

Операция вставки в out << put_money(mon, intl) ведёт себя как функция форматированного вывода.

Параметры

mon - денежное значение: либо long double, либо std::basic_string
intl - использовать международные обозначения валют, если true, в противном случае использовать символы валют

Возвращаемое значение

Объект неуказанного типа, такой что

  • если out является объектом типа std::basic_ostream<CharT, Traits>, выражение out << put_money(mon, intl)
    • имеет тип std::basic_ostream<CharT, Traits>&
    • имеет значение out
    • ведёт себя как функция форматированного вывода, вызывающая f(out, mon, intl)

где функция f определена следующим образом:

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

Пример

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

Возможный вывод:

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

См. также

money_put
форматирует денежное значение для вывода в виде последовательности символов
(шаблон класса)
get_money
(C++11)
разбирает денежное значение
(шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/io/manip/put_money

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API