std::put_money

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

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

语言支持库

概念库(C++20)

诊断库

内存管理库

元编程库(C++11)

通用工具库

容器库

迭代器库

范围库(C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库(C++17)

并发支持库(C++11)

执行控制库(C++26)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵符

打印函数(C++23)

C 风格 I/O

缓冲区

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

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/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步的输出

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	-	货币值，longdouble 或 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 <iomanip>#include <iostream>   int main(){longdouble 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)<<" or "<< std::put_money(mon, true)<<'\n';   std::cout.imbue(std::locale("ru_RU.UTF-8"));std::cout<<"ru_RU: "<< std::put_money(mon)<<" or "<< std::put_money(mon, true)<<'\n';   std::cout.imbue(std::locale("ja_JP.UTF-8"));std::cout<<"ja_JP: "<< std::put_money(mon)<<" or "<< std::put_money(mon, true)<<'\n';}

可能的输出：

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

参阅

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