std::put_money

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵符

打印函数 (C++23)

C 风格 I/O

缓冲

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98 中弃用)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98 中弃用)

ostrstream (C++98 中弃用)

strstream (C++98 中弃用)

同步的输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

输入/输出操纵符

浮点格式化
showpointnoshowpoint setprecision	fixedscientifichexfloatdefaultfloat (C++11)(C++11)
整数格式化
setbase showbasenoshowbase	dechexoct
布尔格式化
boolalphanoboolalpha
域宽与填充控制
setfill setw	internalleftright
其他格式化
showposnoshowpos	uppercasenouppercase
空白符处理
ws ends	skipwsnoskipws
输出冲入
flush endl flush_emit (C++20)	unitbufnounitbuf emit_on_flushnoemit_on_flush (C++20)(C++20)
状态标志操纵
resetiosflags	setiosflags
时间与金钱 I/O
get_money (C++11) get_time (C++11)	put_money (C++11) put_time (C++11)
带引号操纵符
quoted (C++14)

 

在标头 <iomanip> 定义
template< class MoneyT > /*未指定*/ put_money( const MoneyT& mon, bool intl = false );		(C++11 起)

用于表达式 out << put_money(mon, intl) 时，转换货币值 mon 到 out 中当前浸染的本地环境的 std::money_put 平面所指定的字符表示。

out << put_money(mon, intl) 中的插入操作表现为有格式输出函数 (FormattedOutputFunction) 。

参数

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) 的 有格式输出函数 (FormattedOutputFunction)

其中函数 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 <iostream>
#include <iomanip>
 
int main()
{
    long double mon = 123.45; // 或 std::string mon = "123.45";
 
    std::cout.imbue(std::locale("en_US.UTF-8"));
    std::cout << std::showbase
              << "en_US: " << std::put_money(mon)
              << " 或 " << std::put_money(mon, true) << '\n';
 
    std::cout.imbue(std::locale("ru_RU.UTF-8"));
    std::cout << "ru_RU: " << std::put_money(mon)
              << " 或 " << std::put_money(mon, true) << '\n';
 
    std::cout.imbue(std::locale("ja_JP.UTF-8"));
    std::cout << "ja_JP: " << std::put_money(mon)
              << " 或 " << std::put_money(mon, true) << '\n';
}

可能的输出：

en_US: $1.23 或 USD  1.23
ru_RU: 1.23 руб 或 1.23 RUB 
ja_JP: ￥123 或 JPY  123

参阅

money_put	格式化货币值为字符序列以输出 (类模板)
get_money (C++11)	剖析货币值 (函数模板)