CKTIS / C++
std::basic_ios::tie — svázání streamu s výstupním streamem
std::basic_ios::tie zjišťuje nebo mění svázaný výstupní stream. Vazba umožňuje před vstupem vyprázdnit jeho buffer; nullptr vazbu odstraní a nastavovací přetížení vrací předchozí ukazatel.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
std::basic_ostream<charT, traits>* tie() const;
std::basic_ostream<charT, traits>* tie(std::basic_ostream<charT, traits>* tiestr);std::basic_ios::tie má dvě přetížení. tie() vrací ukazatel na svázaný výstupní stream, nebo nullptr. tie(tiestr) nastaví ukazatel a vrátí předchozí hodnotu, nikoli novou. Typy charT a traits obou streamů musí souhlasit.
Když je vstupní stream v dobrém stavu, jeho objekt sentry, který připravuje čtení, zavolá flush() na svázaném výstupním streamu. Standard dovoluje toto volání vynechat, pokud je oblast pro zápis prázdná, a odložit je až do underflow(); pokud k volání nikdy nedojde, může se vyprázdnění zcela vynechat.
Ve výchozím nastavení je std::cin svázán s std::cout, což pomáhá zobrazit výzvu před čekáním na vstup. std::cin.tie(nullptr) tuto vazbu odstraní; případné potřebné vyprázdnění pak musíte zajistit výslovně. Samotné nastavení vazby flush() nevolá.
Nevytvářejte svázání streamu se sebou samým ani nepřímé cykly: porušují předběžnou podmínku a vedou k nedefinovanému chování. Svázaný objekt musí zůstat živý po dobu používání jeho ukazatele. Příklad ověřuje svázání, návratovou hodnotu a obnovení bez interaktivního vstupu.
Příklady
#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';
}
Výsledek
true true 42
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.