命名空间
变体
操作

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

来自 cppreference.com
< 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(),则行为未定义。

内容

[编辑] 参数

str - 要设置为绑定流的输出流

[编辑] 返回值

绑定流,或者如果没有绑定流则为空指针。

[编辑] 异常

可能抛出实现定义的异常。

[编辑] 注释

默认情况下,标准流 std::cout 绑定到 std::cinstd::cerr。类似地,它的宽字符对应物 std::wcout 绑定到 std::wcinstd::wcerr

[编辑] 示例

#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"

[编辑] 缺陷报告

以下行为更改的缺陷报告被追溯应用于以前发布的 C++ 标准。

DR 应用于 已发布的行为 正确行为
LWG 835 C++98 两个流可以相互绑定[1]
(直接或通过另一个中间流对象)
在这种情况下行为未定义
  1. std::basic_ostream::flush() 是一个 UnformattedOutputFunction,因此它在被调用时创建一个哨兵对象。当在流对象上调用 flush() 时,哨兵对象的构造函数 会在其绑定的流上调用 flush(),并且该 flush() 会构造另一个哨兵对象,其构造函数会在该流的绑定的流上调用 flush(),依此类推。因此,如果流 ab(直接或间接)相互绑定,则调用 a.flush() 最终会调用 b.flush(),最终会调用 a.flush(),并将导致无限循环。