定义于头文件 <ostream>
template< class CharT, |
类模板 basic_ostream
提供字符流上的高层输出操作。受支持操作包含有格式输出(例如整数值)和无格式输出(例如生字符和字符数组)。此功能以 basic_streambuf
类所提供的接口实现,通过 basic_ios
基类访问。典型的实现中, basic_ostream
无非继承的数据成员。
有格式输出
插入带格式数据
std::basic_ostream<CharT,Traits>::operator<<
basic_ostream& operator<<( short value ); | (1) | |
basic_ostream& operator<<( int value ); | (2) | |
basic_ostream& operator<<( long value ); | (3) | |
basic_ostream& operator<<( 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<<( | (10) | |
basic_ostream& operator<<( | (11) | |
basic_ostream& operator<<( | (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; // 函数重载
}
输出