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

C++ 参考手册

位置：首页 > C++ 参考手册 >输入/输出库 >std::basic_ostream > std::basic_ostream<CharT,Traits>::operator<<

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<<( std::nullptr_t );	(8)	(C++17 起)
basic_ostream& operator<<( std::basic_streambuf<CharT, Traits>* sb);	(9)
basic_ostream& operator<<( std::ios_base& (*func)(std::ios_base&) );	(10)
basic_ostream& operator<<( std::basic_ios<CharT,Traits>& (*func)(std::basic_ios<CharT,Traits>&) );	(11)
basic_ostream& operator<<( std::basic_ostream<CharT,Traits>& (*func)(std::basic_ostream<CharT,Traits>&) );	(12)

插入数据到流。

1-2) 表现同有格式输出函数 (FormattedOutputFunction) 。在构造并检查 sentry 对象后，若 value 为 short 或 int ，则将它转型为 unsigned short 或 unsigned int ，若 ios_base::flags() & ios_base::basefield 为 ios_base::oct 或 ios_base::hex 。之后，不论任何情况，将它转型为 long 并按 (3) 中方式输出。若 value 是 unsigned short 或 unsigned int ，则将它转型为 unsigned long 并按 (3) 中方式输出。

3-7) 表现同有格式输出函数 (FormattedOutputFunction) 。在构造并检查 sentry 对象后，通过调用 num_put::put() 插入整数、浮点数、布尔或通用指针值。若在输出中遇到文件尾（ put().failed() == true ），则设置 ios::badbit 。

8) 如同用 *this << s 输出实现定义的字符串，其中 s 是空终止字符类型字符串。

9) 表现同无格式输出函数 (UnformattedOutputFunction) 。在构造并检查 sentry 对象后，检查 sb 是否空指针。若它是，则执行 setstate(badbit) 并退出。否则，从 sb 所控制的输入序列释出字符，并将它们插入到 *this ，直至满足下列条件之一为止：

输入序列上出现文件尾；
插入输出序列失败（该情况下不会释出要被插入的字符）；
发生异常（该情况下异常被捕捉）。

若没有插入字符，则执行 setstate(failbit) 。若在释放中抛出异常，则设置 failbit ，而且若 failbit 设置于 exceptions() ，则重抛异常。

10-12) 调用 func(*this) 。这些重载用于实现输出 I/O 操纵符，例如 std::endl 。

参数

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

返回值

1-11) *this

12) func(*this)

注意

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

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

示例

运行此代码

#include <iostream>
#include <iomanip>
#include <sstream>
int main()
{
    std::istringstream input(" \"Some text.\" ");
    volatile int n = 42;
    double f = 3.14;
    bool b = true;
    std::cout << n   // int 重载
              << ' ' // 非成员重载
              << std::boolalpha << b // bool 重载
              << " " // non-member overload
              << std::fixed << f // double 重载
              << input.rdbuf() // streambuf 重载
              << &n // bool 重载： volatile int* 不转换成 const void*
              << std::endl; // 函数重载
}

输出：

42 true 3.140000 "Some text." true

参阅

operator<<(std::basic_ostream)	插入字符数据 (函数)
operator<<operator>>	进行 string 的流 I/O (函数模板)
operator<<operator>>	进行 bitset 的流输入与输出 (函数)
operator<<operator>>	序列化与反序列化复数 (函数模板)
operator<<operator>>	执行伪随机数引擎的流输入和输出 (函数)
operator<<operator>>	执行伪随机数分布的流输入和输出 (函数模板)
put	插入字符 (公开成员函数)
write	插入字符块 (公开成员函数)
to_chars (C++17)	转换整数或浮点值到字符序列 (函数)