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

向流中插入数据。

参数

返回值

注释

不存在针对指向非静态成员的指针 、指向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++标准。

参见