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

std::basic_ostream<CharT,Traits>* tie() const;

std::basic_ostream<CharT,Traits>* tie( std::basic_ostream<CharT,Traits>* str );

Manages the tied stream. A tied stream is an output stream which is synchronized with the sequence controlled by the stream buffer (rdbuf()), that is, flush() is called on the tied stream before any input/output operation on *this.

Parameters

Return value

The tied stream, or a null pointer if there was no tied stream.

Exceptions

May throw implementation-defined exceptions.

Notes

By default, the standard stream cout is tied to cin and cerr. Similarly, its wide counterpart wcout is tied to wcin and wcerr.

Example

#include <iostream>
#include <fstream>
#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(): \"" << value << "\"\n";
    is.clear();
    is.tie(&os);
 
    is >> value;
 
    std::cout << "Result after tie(): \"" << value << "\"\n";
}

Result before tie(): "0"
Result after tie(): "Hello"