CKTIS / C++
std::basic_ios::tie — обвързване на поток с изходен поток
std::basic_ios::tie проверява или променя обвързания изходен поток. Обвързването позволява буферът му да бъде изчистен преди вход; nullptr премахва обвързването, а настройващото претоварване връща предишния указател.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
std::basic_ostream<charT, traits>* tie() const;
std::basic_ostream<charT, traits>* tie(std::basic_ostream<charT, traits>* tiestr);std::basic_ios::tie има две претоварвания. tie() връща указател към обвързания изходен поток или nullptr. tie(tiestr) задава указателя и връща предишната стойност, а не новата. Типовете charT и traits на двата потока трябва да съвпадат.
Когато входен поток е в добро състояние, неговият обект sentry, който подготвя четенето, извиква flush() за обвързания изходен поток. Стандартът позволява това извикване да бъде пропуснато, ако областта за запис е празна, и отложено до underflow(); ако извикването изобщо не се състои, изчистването може да бъде напълно пропуснато.
По подразбиране std::cin е обвързан с std::cout, което помага да се покаже подкана, преди да се изчака вход. std::cin.tie(nullptr) премахва тази връзка; тогава трябва изрично да осигурите всяко необходимо изчистване. Самото задаване на връзка не извиква flush().
Не създавайте обвързване на поток със самия него или косвени цикли: те нарушават предусловието и водят до неопределено поведение. Обвързаният обект трябва да остане жив, докато указателят му се използва. Примерът проверява обвързването, върнатата стойност и възстановяването му, без интерактивен вход.
Примери
#include <iostream>
#include <sstream>
int main() {
std::ostringstream output;
std::istringstream input("42");
auto* previous = input.tie(&output);
const bool attached = input.tie() == &output;
output << "ready";
int value = 0;
input >> value;
auto* removed = input.tie(previous);
std::cout << std::boolalpha
<< attached << '\n'
<< (removed == &output) << '\n'
<< value << '\n';
}
Резултат
true true 42
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.