命名空间
变体
操作

std::basic_ios<CharT,Traits>::tie

来自 cppreference.cn
< cpp‎ | io‎ | basic ios
 
 
 
 
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::coutstd::cinstd::cerr 关联。 同样,其宽字符对应物 std::wcoutstd::wcinstd::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]
(直接地或通过另一个中间流对象)
在这种情况下,行为是未定义的
  1. std::basic_ostream::flush() 是一个 UnformattedOutputFunction,因此它在被调用时创建一个 sentry 对象。当在流对象上调用 flush() 时,sentry 对象的构造函数 将在其关联流上调用 flush(),并且该 flush() 将构造另一个 sentry 对象,并且其构造函数将在该流的关联流上调用 flush(),依此类推。因此,如果流 ab (直接或间接地)相互关联,则调用 a.flush() 最终将调用 b.flush(),这将最终调用 a.flush(),并将导致无限循环。