std::basic_ostream<CharT,Traits>::operator<<
来自cppreference.com
| |
(1) | |
| (2) | ||
| |
(3) | |
| |
(4) | (C++11 起) |
| |
(5) | (C++11 起) |
| |
(6) | |
| |
(7) | |
| (8) | ||
| |
(9) | (C++23 起) |
| |
(10) | (C++17 起) |
| (11) | ||
| |
(12) | |
| |
(13) | |
| |
(14) | |
| |
(15) | |
| |
(16) | (C++23 起) |
| |
(17) | |
| (18) | ||
| |
(19) | |
| |
(20) | |
将数据插入到流。
1-8) 插入
value。 此函数表现为有格式输出函数 (FormattedOutputFunction) 。在构造并检查 sentry 对象后，通过调用 std::num_put::put() 插入值。如果在输出中遇到文件尾（
put().failed() == true），那么就会设置 badbit。9) 等价于
return operator<<(const_cast<const void*>(p));。10) 等价于
return *this << s;，其中 s 是由实现定义的空终止字符类型字符串。11) 插入来自
short value 的值。 此函数表现为有格式输出函数 (FormattedOutputFunction) 。在构造并检查 sentry 对象后，按 (2) 中的方式插入
long 值 lval，其中 lval：
- 在
flags() & std::ios_base::basefield是 std::ios_base::oct 或 std::ios_base::hex 时是static_cast<long>(static_cast<unsigned short>(value))； - 否则是
static_cast<long>(value)。
12) 插入来自
int value 的值。 此函数表现为有格式输出函数 (FormattedOutputFunction) 。在构造并检查 sentry 对象后，按 (2) 中的方式插入
long 值 lval，其中 lval：
- 在
flags() & std::ios_base::basefield是 std::ios_base::oct 或 std::ios_base::hex 时是static_cast<long>(static_cast<unsigned int>(value))； - 否则是
static_cast<long>(value)。
13,14) 插入来自
unsigned short 或 unsigned int value 的值。 此函数表现为有格式输出函数 (FormattedOutputFunction) 。在构造并检查 sentry 对象后，按 (3) 中的方式插入
static_cast<unsigned long>(value)。15) 插入来自
float value 的值。 此函数表现为有格式输出函数 (FormattedOutputFunction) 。在构造并检查 sentry 对象后，检查
/* 扩展浮点数类型 */ 的浮点数转换等级：
- 如果该等级低于或等于
double的等级，按 (6) 中的方式插入static_cast<double>(value)。 - 否则，如果该等级低于或等于
long double的等级，按 (7) 中的方式插入static_cast<long double>(value)。 - 否则，对此重载的调用受条件性支持，并且语义由实现定义。
17) 表现为无格式输出函数 (UnformattedOutputFunction) 。在构造并检查 sentry 对象后，检查
sb 是否为空指针。是的情况下执行 setstate(badbit) 并退出。否则，从 sb 控制的输入序列提取字符，并将它们插入到 *this，直到满足下列条件之一为止：
- 输入序列上出现文件尾；
- 插入输出序列失败（此时不会提取要被插入的字符）；
- 发生异常（此时异常会被捕获）。
setstate(failbit)。如果在提取中抛出异常，那么就会设置 failbit，而且如果在 exceptions() 设置里 failbit，那么就会重抛异常。18-20) 调用
func(*this)。这些重载用于实现用于输出的输入/输出操纵符，例如 std::endl。参数
| value | - | 要插入的整数、浮点数、布尔值或指针 |
| func | - | 要调用的函数 |
| sb | - | 指向要从之读取数据的流缓冲区的指针 |
返回值
1-19)
*this20)
func(*this)注解
没有对指向非静态数据成员指针、指向 volatile 指针(C++23 前)或函数指针（除了拥有 (18-20) 重载所接受之签名者）的重载。
- 试图输出这种对象会引发到
bool的隐式转换，并对于任何非空指针值将打印值1（除非设置了boolalpha，此时会打印true）。
字符与字符串实参（例如拥有 char 类型或 const char* 类型者）由 operator<< 的非成员重载处理。
- 试图用成员函数调用语法输出字符（例如
std::cout.operator<<('c');）会调用重载 (2-5) 或 (11-14) 之一，并输出数字值。 - 试图用成员函数调用语法输出字符串会调用重载 (8) 而改为打印指针值。
重载 (10) 由 LWG 问题 2221的解决方案添加，但是没有任何标准库实现在 C++11/14 模式下实现它。
示例
运行此代码
#include <iomanip>
#include <iostream>
#include <sstream>
int fun() { return 42; }
int main()
{
std::istringstream input(" \"Some text.\" ");
double f = 3.14;
bool b = true;
std::cout
<< fun() // int 重载 (12)
<< ' ' // 非成员重载
<< std::boolalpha // 函数重载 (18)
<< b // bool 重载 (1)
<< " " // 非成员重载
<< std::fixed // 又是函数重载 (18)
<< f // double 重载 (6)
<< input.rdbuf() // streambuf 重载
<< fun // bool 重载 (1)：没有 int(*)() 的重载
<< std::endl; // 又是函数重载 (18)
int x = 0;
int* p1 = &x;
volatile int* p2 = &x;
std::cout
<< "p1: " << p1 << '\n' // `const void*` 重载，打印地址
<< "p2: " << p2 << '\n'; // C++23 (P1147) 之前: bool 重载 :)
// 因为其并不匹配 operator<<(const void*)，由于它舍弃了 `volatile` 限定符。
// 为修正这点，C++23 添加了 `const volatile void*` 的重载 (9)，
// 它按预期打印了地址。
}
可能的输出：
42 true 3.140000 "Some text." true
p1: 0x7ffcea766600
p2: 0x7ffcea766600
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| 缺陷报告 | 应用于 | 出版时的行为 | 正确行为 |
|---|---|---|---|
| LWG 117 | C++98 | 重载 (1-8,11-15) 通过 num_put::put 代理插入操作，但它没有为short，unsigned short，int，unsigned int 以及 float 重载
|
它们在传递到 num_put::put之前会先进行转换 |
| LWG 567 | C++98 | 重载 (17) 因 LWG 问题 60 的解决方案而表现为 有格式输出函数 (FormattedOutputFunction) |
表现为 无格式输出函数 (UnformattedOutputFunction) |