std::basic_ostream<CharT,Traits>::operator<<
来自cppreference.com
< cpp | io | 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 ); |
(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 ,则将它转型为 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) 将
value
转型到 const void* 并按 (7) 输出。9) 如同用 *this << s 输出实现定义的字符串,其中
s
是空终止字符类型字符串。10) 表现同无格式输出函数 (UnformattedOutputFunction) 。在构造并检查 sentry 对象后,检查
sb
是否空指针。若它是,则执行 setstate(badbit) 并退出。否则,从 sb
所控制的输入序列释出字符,并将它们插入到 *this ,直至满足下列条件之一为止:
- 输入序列上出现文件尾;
- 插入输出序列失败(该情况下不会释出要被插入的字符);
- 发生异常(该情况下异常被捕捉)。
failbit
设置于 exceptions() ,则重抛异常。参数
value | - | 要插入的整数、浮点、布尔或指针值 |
func | - | 要调用的函数 |
sb | - | 指向要自之读取数据的 streambuffer 的指针 |
返回值
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 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
参阅
插入字符数据 (函数) | |
执行字符串的流输入与输出 (函数模板) | |
执行 bitset 的流输入和输出 (函数) | |
复数的序列化和反序列化 (函数模板) | |
(C++11) |
执行伪随机数引擎的流输入和输出 (函数) |
(C++11) |
执行伪随机数分布的流输入和输出 (函数模板) |
插入字符 (公开成员函数) | |
插入字符块 (公开成员函数) | |
(C++17) |
转换整数或浮点值到字符序列 (函数) |