std::basic_ios<CharT,Traits>::tie
来自 cppreference.cn
std::basic_ostream<CharT, Traits>* tie() const; |
(1) | |
std::basic_ostream<CharT, Traits>* tie( std::basic_ostream<CharT, Traits>* str ); |
(2) | |
管理关联流。关联流是一个输出流,它与流缓冲区 (rdbuf()) 控制的序列同步,也就是说,在 *this 上的任何输入/输出操作之前,都会在关联流上调用 flush()。
1) 返回当前的关联流。如果没有关联流,则返回空指针。
2) 将当前关联流设置为 str。返回操作之前的关联流。如果没有关联流,则返回空指针。如果 str 不为空,并且通过从 str->tie() 开始遍历关联流对象的链表可以访问 tie(),则行为未定义。
目录 |
[edit] 参数
str | - | 要设置为关联流的输出流 |
[edit] 返回值
关联流,或者如果没有关联流,则为空指针。
[edit] 异常
可能抛出实现定义的异常。
[edit] 注解
默认情况下,标准流 std::cout 与 std::cin 和 std::cerr 关联。 同样,其宽字符对应物 std::wcout 与 std::wcin 和 std::wcerr 关联。
[edit] 示例
运行此代码
#include <fstream> #include <iomanip> #include <iostream> #include <string> int main() { std::ofstream os("test.txt"); std::ifstream is("test.txt"); std::string value("0"); os << "Hello"; is >> value; std::cout << "Result before tie(): " << std::quoted(value) << "\n"; is.clear(); is.tie(&os); is >> value; std::cout << "Result after tie(): " << std::quoted(value) << "\n"; }
输出
Result before tie(): "0" Result after tie(): "Hello"
[edit] 缺陷报告
以下行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。
DR | 应用于 | 已发布行为 | 正确行为 |
---|---|---|---|
LWG 835 | C++98 | 两个流可以相互关联[1] (直接地或通过另一个中间流对象) |
在这种情况下,行为是未定义的 |
- ↑ std::basic_ostream::flush() 是一个 UnformattedOutputFunction,因此它在被调用时创建一个 sentry 对象。当在流对象上调用
flush()
时,sentry 对象的构造函数 将在其关联流上调用flush()
,并且该flush()
将构造另一个 sentry 对象,并且其构造函数将在该流的关联流上调用flush()
,依此类推。因此,如果流 a 和 b (直接或间接地)相互关联,则调用 a.flush() 最终将调用 b.flush(),这将最终调用 a.flush(),并将导致无限循环。