Namespaces
Variants
Views
Actions

std::basic_ios::tie

From cppreference.com
< cpp‎ | io‎ | basic ios
Revision as of 08:10, 15 August 2013 by P12 (Talk | contribs)

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, NULL is returned.
2) Sets the current tied stream to str. Returns the tied stream before the operation. If there is no tied stream, NULL is returned.

Contents

Parameters

str - an output stream to set as the tied stream

Return value

The tied stream, or NULL if there was no tied stream.

Exceptions

(none)

Notes

By default, the standard streams cin, cerr and clog are tied to cout. Similarly, their wide counterparts wcin, wcerr and wclog are tied to wcout.

Example