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/facet

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

Если специализация 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

Члены данных

Член Описание
std::locale::id id [static] идентификатор аспекта

Функции-члены

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

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

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

Пример

#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++.

Отчёт об ошибке Применяется к Опубликованное поведение Правильное поведение
LWG 427 C++98 money_put гарантировалось, что принимает любой CharT, который
удовлетворяет требованиям к символу, для которого
могут быть созданы любые компоненты iostream
гарантируется, что принимает только char,
wchar_t и другие определяемые
реализацией типы символов
LWG 2392 C++98 гарантировалось, что money_put принимает
только тип символа CharT
может гарантироваться приём типов контейнеров символов,
определяемых реализацией

См. также

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/cpp/locale/money_put

Spec-Zone.ru

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