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 |
Члены-функции
создаёт новый компонент money_put (публичная функция-член) |
|
вызывает do_put (публичная функция-член) |
Защищённые функции-члены
уничтожает компонент money_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, другие типы определяются реализацией |
См. также
определяет параметры денежного форматирования, используемые 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/w/cpp/locale/money_put