std::basic_ostream<CharT,Traits>::operator<<

来自cppreference.com
< cpp‎ | io‎ | basic ostream
 
C++
 
输入/输出库
 
std::basic_ostream
 
basic_ostream& operator<<( short value );
basic_ostream& operator<<( unsigned short value );
 (1)
basic_ostream& operator<<( int value );
basic_ostream& operator<<( unsigned int value );
 (2)
basic_ostream& operator<<( long value );
basic_ostream& operator<<( unsigned long value );
 (3)
basic_ostream& operator<<( long long value );
basic_ostream& operator<<( unsigned long long value );
 (4) (C++11 起)
basic_ostream& operator<<( float value );

basic_ostream& operator<<( double value );

basic_ostream& operator<<( long double value );
 (5)
basic_ostream& operator<<( bool value );
 (6)
basic_ostream& operator<<( const void* value );
 (7)
basic_ostream& operator<<( const volatile void* value );
 (8) (C++23 起)
basic_ostream& operator<<( std::nullptr_t );
 (9) (C++17 起)
basic_ostream& operator<<( std::basic_streambuf<CharT, Traits>* sb );
 (10)
basic_ostream& operator<<(
    std::ios_base& (*func)(std::ios_base&) );
 (11)
basic_ostream& operator<<(
    std::basic_ios<CharT,Traits>& (*func)(std::basic_ios<CharT,Traits>&) );
 (12)
basic_ostream& operator<<(
    std::basic_ostream<CharT,Traits>& (*func)(std::basic_ostream<CharT,Traits>&) );
 (13)

插入数据到流。

1-2) 表现为有格式输出函数 (FormattedOutputFunction) 。在构造并检查 sentry 对象后，如果 value 是 short 或 int 且 ios_base::flags() & ios_base::basefield 是 ios_base::oct 或 ios_base::hex，那么将 value 转型到 unsigned short 或 unsigned int。之后，不论任何情况，将它转型到 long 并按 (3) 中的方式输出。如果 value 是 unsigned short 或 unsigned int，那么将它转型到 unsigned long 并按 (3) 中的方式输出。
3-7) 表现为有格式输出函数 (FormattedOutputFunction) 。在构造并检查 sentry 对象后，通过调用 std::num_put::put() 插入整数、浮点数、布尔或通用指针值。如果在输出中遇到文件尾（put().failed() == true），那么就会设置 ios::badbit。
8) 将 value 转型到 const void* 并按 (7) 输出。
9) 如同用 *this << s 输出实现定义的字符串，其中 s 是空终止字符类型字符串。
10) 表现为无格式输出函数 (UnformattedOutputFunction) 。在构造并检查 sentry 对象后，检查 sb 是否为空。是的情况下执行 setstate(badbit) 并退出。否则，从 sb 控制的输入序列提取字符，并将它们插入到 *this，直到满足下列条件之一为止：
  • 输入序列上出现文件尾；
  • 插入输出序列失败（此时不会提取要被插入的字符）；
  • 发生异常（此时异常会被捕获）。
如果没有插入字符，那么执行 setstate(failbit)。如果在提取中抛出异常，那么就会设置 failbit，而且如果在 exceptions() 设置里 failbit，那么就会重抛异常。
11-13) 调用 func(*this)。这些重载用于实现用于输出的输入/输出操纵符，例如 std::endl。

参数

value - 要插入的整数、浮点、布尔或指针值
func - 要调用的函数
sb - 指向要自之读取数据的流缓冲区的指针

返回值

1-11) *this
12) func(*this)

注解

没有对指向非静态数据成员指针、指向 volatile 指针 (C++23 前)或函数指针（除了拥有 (11-13) 重载所接受之签名者）的重载。试图输出这种对象会引发到 bool 的隐式转换，并对于任何非空指针值打印值 1（除非设置了 boolalpha，此时会打印 true）。

字符与字符串参数（例如拥有 char 类型或 const char* 类型者）以 operator<< 的非成员重载处理。试图用成员函数调用语法（例如 std::cout.operator<<('c'); ）会调用重载 (2-4) 之一，并输出数字值。试图用成员函数调用语法输出字符串会调用重载 (7) 而改为打印指针值。

示例

运行此代码
#include <iostream>
#include <iomanip>
#include <sstream>
 
int fun() { return 42; }
 
int main()
{
    std::istringstream input(" \"Some text.\" ");
    double f = 3.14;
    bool b = true;
    std::cout << fun() // int 重载
              << ' ' // 非成员重载
              << std::boolalpha << b // bool 重载
              << " " // 非成员重载
              << std::fixed << f // double 重载
              << input.rdbuf() // streambuf 重载
              << fun // bool 重载：没有 int(*)() 的重载
              << std::endl; // 函数重载
}

输出： 

42 true 3.140000 "Some text." true

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 出版时的行为 正确行为
LWG 117 C++98 重载 (1)-(7) 通过 num_put::put 代理插入操作，但它没有为 short，
unsigned short，int，unsigned int 以及 float 重载 		它们在传递到 num_put::put
之前会先进行转换

参阅

 插入字符数据
(函数)
执行字符串的流输入与输出
(函数模板)
执行 bitset 的流输入和输出
(函数)
复数的序列化和反序列化
(函数模板)
(C++11)
 执行伪随机数引擎的流输入和输出
(函数)
(C++11)
 执行伪随机数分布的流输入和输出
(函数模板)
插入字符
(公开成员函数)
插入字符块
(公开成员函数)
(C++17)
 转换整数或浮点值到字符序列
(函数)
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/io/basic_ostream/operator_ltlt&oldid=74868”