std::basic_ios<CharT,Traits>::tie
From cppreference.com
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Input/output library
Print functions (C++23)
Buffers
(C++23)
(C++98/26*)
(C++20)
Streams
Abstractions
File I/O
String I/O
Array I/O
(C++23)
(C++23)
(C++23)
(C++98/26*)
(C++98/26*)
(C++98/26*)
Synchronized Output
(C++20)
Types
Error category interface
(C++11)
(C++11)
std::basic_ios
Member functions
State functions
Formatting
Miscellaneous
basic_ios::tie
Protected member functions
(C++11)
(C++11)
(C++11)
std::basic_ostream <CharT, Traits>* tie() const;
(1)
std::basic_ostream <CharT, Traits>* tie( std::basic_ostream <CharT, Traits>* str );
(2)
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.
1) Returns the current tied stream. If there is no tied stream, a null pointer is returned.
2) Sets the current tied stream to str. Returns the tied stream before the operation. If there is no tied stream, a null pointer is returned. If str is not null and tie() is reachable by traversing the linked list of tied stream objects starting from str->tie(), the behavior is undefined.
[edit] Parameters
str
-
an output stream to set as the tied stream
[edit] Return value
The tied stream, or a null pointer if there was no tied stream.
[edit] Exceptions
May throw implementation-defined exceptions.
[edit] Notes
By default, the standard stream std::cout is tied to std::cin and std::cerr . Similarly, its wide counterpart std::wcout is tied to std::wcin and std::wcerr .
[edit] Example
Run this code
#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"; }
Output:
Result before tie(): "0" Result after tie(): "Hello"
[edit] Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 835 | C++98 | two streams could be tied to each other[1] (either directly or through another intermediate stream object) |
the behavior is undefined in this case |
- ↑ std::basic_ostream::flush() is an UnformattedOutputFunction, so it creates a sentry object while being called. When
flush()is called on a stream object, the constructor of the sentry object will callflush()on its tied stream, and thatflush()will construct another sentry object and its constructor will callflush()on the tied stream of that stream and so on. Therefore, if streams a and b are (directly or indirectly) tied to each other, calling a.flush() will eventually call b.flush(), which will eventually call a.flush(), and will result in an infinite loop.