CKTIS / C++
std::basic_ios::tie — einen Stream an einen Ausgabestream koppeln
std::basic_ios::tie fragt den gekoppelten Ausgabestream ab oder ändert ihn. Die Kopplung ermöglicht es, dessen Puffer vor einer Eingabe zu leeren; nullptr hebt sie auf, und die Setter-Überladung gibt den vorherigen Zeiger zurück.
Version: 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 hat zwei Überladungen. tie() gibt den Zeiger auf den gekoppelten Ausgabestream oder nullptr zurück. tie(tiestr) setzt den Zeiger und gibt den vorherigen Wert zurück, nicht den neuen. Die Typen charT und traits beider Streams müssen übereinstimmen.
Wenn ein Eingabestream in einem guten Zustand ist, ruft sein sentry-Objekt zur Vorbereitung der Eingabe flush() für den gekoppelten Ausgabestream auf. Der Standard erlaubt, diesen Aufruf bei leerem Ausgabebereich zu unterdrücken und bis zu underflow() aufzuschieben; wenn der Aufruf nie erfolgt, kann das Leeren ganz entfallen.
Standardmäßig ist std::cin an std::cout gekoppelt. So kann eine Eingabeaufforderung angezeigt werden, bevor auf Eingaben gewartet wird. std::cin.tie(nullptr) hebt die Kopplung auf; erforderliches Leeren muss dann ausdrücklich veranlasst werden. Das Setzen einer Kopplung allein ruft kein flush() auf.
Erzeuge weder Selbstkopplungen noch indirekte Zyklen: Sie verletzen die Vorbedingung und führen zu undefiniertem Verhalten. Das gekoppelte Objekt muss während der Verwendung seines Zeigers am Leben bleiben. Das Beispiel prüft die Kopplung, den Rückgabewert und die Wiederherstellung ohne interaktive Eingabe.
Beispiele
#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';
}
Ergebnis
true true 42
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.