Spec-Zone.ru › C++

std::money_put

Определено в заголовке <locale>
template< 
    class CharT,
    class OutputIt = std::ostreambuf_iterator<CharT>
> class money_put;

Класс std::money_put описывает правила форматирования денежных значений в виде строк. Стандартный манипулятор ввода-вывода std::put_money использует компонент std::money_put области локализации потока ввода-вывода.

cpp/locale/locale/facetstd-money put-inheritance.svg

Диаграмма наследования

Если специализация std::money_put не гарантируется стандартной библиотекой (см. ниже), поведение её put() и do_put() не гарантируется в соответствии со спецификацией.

Специализации

Стандартная библиотека гарантирует предоставление следующих специализаций (они должны быть реализованы любой областью локализации):

Определено в заголовке <locale>
std::money_put<char> создаёт узкие строковые представления денежных значений
std::money_put<wchar_t> создаёт широкие строковые представления денежных значений

Кроме того, стандартная библиотека гарантирует предоставление всех специализаций, удовлетворяющих следующим требованиям типа:

  • CharT является одним из
    • char,
    • wchar_t, и
    • любым другим типом символа, определённым реализацией, который удовлетворяет требованиям символа, на котором могут быть инициированы любые компоненты iostream; и
  • OutputIt должен удовлетворять требованиям LegacyOutputIterator.

Типы членов

Тип члена Определение
char_type CharT
string_type std::basic_string<CharT>
iter_type OutputIt

Члены-функции

(конструктор)
создаёт новый компонент money_put
(публичная функция-член)
put
вызывает do_put
(публичная функция-член)

Защищённые функции-члены

(деструктор)
уничтожает компонент money_put
(защищённая функция-член)
do_put
[виртуальный]
форматирует денежное значение и записывает его в поток вывода
(виртуальная защищённая функция-член)

Члены-объекты

static std::locale::id id
id области локализации
(публичный член-объект)

Пример

#include <iomanip>
#include <iostream>
#include <iterator>
#include <locale>
 
int main()
{
    // using the I/O manipulator
    std::cout.imbue(std::locale("en_US.UTF-8"));
    std::cout << "American locale: "
              << std::showbase << std::put_money(12345678.9) << '\n';
 
    // using the facet directly
    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, другие типы
определяются реализацией

См. также

moneypunct
определяет параметры денежного форматирования, используемые std::money_get и std::money_put
(шаблон класса)
money_get
анализирует и строит денежное значение из входной последовательности символов
(шаблон класса)
put_money
(C++11)
форматирует и выводит денежное значение
(шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/locale/money_put

Spec-Zone.ru

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