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 локали потока ввода-вывода.
Диаграмма наследования
Если специализация 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 (открытая функция-член) |
|
вызывает do_put (открытая функция-член) |
Защищённые функции-члены
уничтожает аспект money_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 | может гарантироваться приём типов контейнеров символов, определяемых реализацией |
См. также
задаёт параметры форматирования денежных значений, используемые std::money_get и std::money_put (шаблон класса) |
|
| разбирает входную последовательность символов и создаёт денежное значение (шаблон класса) |
|
|
(C++11) | форматирует и выводит денежное значение (шаблон функции) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/locale/money_put