CKTIS / C++
std::basic_ios::tie — previaže stream s výstupným streamom
std::basic_ios::tie zisťuje alebo mení previazaný výstupný stream. Previazanie umožňuje pred vstupom vyprázdniť jeho buffer; nullptr previazenie odstráni a nastavovací overload vracia predchádzajúci ukazovateľ.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
std::basic_ostream<charT, traits>* tie() const;
std::basic_ostream<charT, traits>* tie(std::basic_ostream<charT, traits>* tiestr);std::basic_ios::tie má dva overloady. tie() vracia ukazovateľ na previazaný výstupný stream alebo nullptr. tie(tiestr) nastaví ukazovateľ a vráti predchádzajúcu hodnotu, nie novú. Typy charT a traits oboch streamov sa musia zhodovať.
Keď je vstupný stream v dobrom stave, jeho objekt sentry, ktorý pripravuje čítanie, zavolá flush() na previazanom výstupnom streame. Štandard povoľuje toto volanie vynechať, ak je oblasť na zápis prázdna, a odložiť ho až na underflow(); ak k volaniu nikdy nedôjde, vyprázdnenie možno úplne vynechať.
Predvolene je std::cin previazaný s std::cout, čo pomáha zobraziť výzvu pred čakaním na vstup. std::cin.tie(nullptr) toto previazenie odstráni; prípadné potrebné vyprázdnenie potom musíte zabezpečiť výslovne. Samotné nastavenie previazenia nevolá flush().
Nevytvárajte previazenie streamu so sebou samým ani nepriame cykly: porušujú predbežnú podmienku a vedú k nedefinovanému správaniu. Previazaný objekt musí zostať živý, kým sa používa jeho ukazovateľ. Príklad overuje previazenie, návratovú hodnotu a obnovenie bez interaktívneho vstupu.
Prí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ýsledok
true true 42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.