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 );

Управляет привязанным потоком. Привязанный поток — это поток вывода, который синхронизирован с последовательностью, управляемой буфером потока (rdbuf()), то есть, flush() вызывается на привязанном потоке перед любой операцией ввода/вывода на *this.

Параметры

Значение возврата

Привязанный поток или указатель null, если привязанного потока не было.

Исключения

Может выбросить исключение, определенное реализацией.

Примечания

По умолчанию стандартный поток std::cout привязан к std::cin и std::cerr. Аналогично, его широкий аналог std::wcout привязан к std::wcin и std::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++.

1. std::basic_ostream::flush() является Функцией неформатированного вывода, поэтому при вызове создаёт объект-сторож. При вызове flush() на объекте потока конструктор объекта-сторожа вызовет flush() на привязанном потоке, и этот flush() создаст другой объект-сторожа, и его конструктор вызовет flush() на привязанном потоке этого потока и так далее. Таким образом, если потоки a и b (прямо или косвенно) привязаны друг к другу, вызов a.flush() в конечном итоге вызовет b.flush(), который в конечном итоге вызовет a.flush(), что приведёт к бесконечной петле.