operator<<(std::basic_ostream)
来自cppreference.com
| 在标头 <ostream> 定义
|
||
basic_ostream 与字符 |
||
| (1) | ||
| |
||
| |
||
| |
||
| |
||
| |
||
basic_ostream 与字符数组 |
||
| (2) | ||
| |
||
| |
||
| |
||
| |
||
| |
||
basic_ostream 右值 |
||
| |
(3) | (C++11 起) |
basic_ostream 与 UTF 字符/数组的被删除重载 |
||
| (4) | (C++20 起) | |
| |
||
| |
||
| |
||
| |
||
| |
||
| |
||
| |
||
| |
||
| |
||
| |
||
| |
||
| |
||
| |
||
| |
||
插入字符或字符串。
1) 表现为有格式输出函数 (FormattedOutputFunction) 。在构造并检查 sentry 对象后，插入字符
ch。如果 ch 具有 char 类，而 os 的字符容器类型不是 char，那么改为插入 os.widen(ch)。 按下列方式确定填充：
- 如果
os.width() > 1，那么向输出字符添加os.width() - 1个os.fill()的副本，以组成输出字符序列。 - 如果
(out.flags() & std::ios_base::adjustfield) == std::ios_base::left，那么填充字符被置于输出字符之后，否则在其之前。
在插入后，调用
os.width(0) 以取消 std::setw 的效果（如果存在）。2) 表现为有格式输出函数 (FormattedOutputFunction) 。在构造并检查 sentry 对象后，插入来自以
s 指向其首元素的字符数组中的相继字符。
- 对于第一和第三重载（其中
CharT匹配ch的类型），恰好插入traits::length(s)个字符。 - 对于第二重载，恰好插入
std::char_traits<char>::length(s)个字符。 - 对于最后两个重载，恰好插入
traits::length(reinterpret_cast<const char*>(s))个字符。
在插入前，首先用
os.widen() 加宽所有字符，然后按下列方式确定填充：
- 如果要插入的字符数少于
os.width()，那么向字符序列添加足够数量的os.fill()副本，使得它的长度等于os.width()。 - 如果
(out.flags() & std::ios_base::adjustfield) == std::ios_base::left，那么向输出序列的末尾添加填充字符，否则将它们添加到序列之前。
在插入后，调用
os.width(0) 以取消 std::setw 的效果（如果存在）。 在
s 是空指针时行为未定义。3) 给定到输出流对象的右值引用，调用适当的插入运算符（等价于
os << value）。此重载只有在表达式 os << value 良构且 Ostream 是公开且无歧义地派生自 std::ios_base 的类类型时才会参与重载决议。4) 接受
char16_t、char32_t 等类型（或它们的空终止序列）的重载被弃置：不允许 std::cout << u'X'。这些重载之前会打印整数或指针值。参数
| os | - | 要插入数据的输出流 |
| ch | - | 要插入的字符 |
| s | - | 指向要插入的字符串的指针 |
返回值
1,2)
os3)
std::move(os)注解
在解决 LWG 问题 1203 前，如 (std::ostringstream() << 1.2).str() 的代码无法编译。
示例
运行此代码
#include <fstream>
#include <iostream>
void foo()
{
// 错误：operator<< (basic_ostream<char, _Traits>&, char8_t) 被弃置
// std::cout << u8'z' << '\n';
}
std::ostream& operator<<(std::ostream& os, char8_t const& ch)
{
return os << static_cast<char>(ch);
}
int main()
{
std::cout << "Hello, world" // 使用 const char* 重载
<< '\n'; // 使用 char 重载
std::ofstream("test.txt") << 1.2; // 使用右值重载
std::cout << u8'!' << '\n'; // 使用程序定义的 operator<<(os, char8_t const&)
}
输出：
Hello, world
!
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| 缺陷报告 | 应用于 | 出版时的行为 | 正确行为 |
|---|---|---|---|
| LWG 167 | C++98 | (2) 中的所有重载插入的字符数 都是 traits::length(s)
|
更新 CharT 与 ch 的类型不匹配的重载插入的字符数 |
| LWG 1203 | C++11 | 右值流的重载返回到基类的左值引用 | 返回到派生类的右值引用 |
| LWG 2011 | C++98 | 填充由 std::num_put::do_put() 确定 | 由运算符自身确定 |
| LWG 2534 | C++11 | 右值流的重载未被制约 | 已制约 |
参阅
| 插入带格式数据 (公开成员函数) | |
(C++23) |
输出各实参的格式化表示 (函数模板) |
| 拓宽字符 ( std::basic_ios<CharT,Traits> 的公开成员函数)
|