CKTIS / C++
std::basic_ios::tie — een stream koppelen aan een uitvoerstream
std::basic_ios::tie vraagt de gekoppelde uitvoerstream op of wijzigt deze. Door de koppeling kan de buffer vóór invoer worden geleegd; nullptr verwijdert de koppeling en de setter-overload retourneert de vorige pointer.
Versie: 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 heeft twee overloads. tie() retourneert de pointer naar de gekoppelde uitvoerstream of nullptr. tie(tiestr) stelt de pointer in en retourneert de vorige waarde, niet de nieuwe. De typen charT en traits van beide streams moeten overeenkomen.
Wanneer een invoerstream in een goede toestand verkeert, roept het sentry-object dat de invoer voorbereidt flush() aan op de gekoppelde uitvoerstream. De standaard staat toe deze aanroep achterwege te laten als het uitvoergebied leeg is, en uit te stellen tot underflow(); als de aanroep nooit plaatsvindt, kan het legen helemaal vervallen.
Standaard is std::cin gekoppeld aan std::cout, zodat een prompt kan worden weergegeven voordat op invoer wordt gewacht. std::cin.tie(nullptr) verwijdert deze koppeling; zorg dan zelf expliciet voor eventueel vereist legen. Alleen een koppeling instellen roept geen flush() aan.
Maak geen koppeling van een stream met zichzelf en geen indirecte cycli: die schenden de voorwaarde en leiden tot ongedefinieerd gedrag. Het gekoppelde object moet blijven bestaan zolang de pointer wordt gebruikt. Het voorbeeld controleert de koppeling, de retourwaarde en het herstel ervan, zonder interactieve invoer.
Voorbeelden
#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';
}
Resultaat
true true 42
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.