CKTIS / C++
std::basic_ios::tie — collegare uno stream a uno stream di output
std::basic_ios::tie consulta o modifica lo stream di output collegato. Il collegamento permette di svuotarne il buffer prima della lettura; nullptr lo rimuove e l’overload che lo imposta restituisce il puntatore precedente.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
std::basic_ostream<charT, traits>* tie() const;
std::basic_ostream<charT, traits>* tie(std::basic_ostream<charT, traits>* tiestr);std::basic_ios::tie ha due overload. tie() restituisce il puntatore allo stream di output collegato oppure nullptr. tie(tiestr) imposta il puntatore e restituisce il valore precedente, non quello nuovo. I tipi charT e traits dei due stream devono corrispondere.
Quando uno stream di input è in buono stato, il suo oggetto sentry, che prepara la lettura, chiama flush() sullo stream di output collegato. Lo standard consente di sopprimere questa chiamata se l’area di output è vuota e di rimandarla fino a underflow(); se la chiamata non avviene mai, lo svuotamento può essere omesso del tutto.
Per impostazione predefinita, std::cin è collegato a std::cout, così è possibile mostrare un messaggio prima di attendere l’input. std::cin.tie(nullptr) rimuove il collegamento; in tal caso occorre predisporre esplicitamente ogni svuotamento necessario. Impostare un collegamento, da solo, non chiama flush().
Non creare collegamenti di uno stream con se stesso né cicli indiretti: violano la precondizione e causano comportamento indefinito. L’oggetto collegato deve rimanere in vita finché il suo puntatore viene utilizzato. L’esempio verifica il collegamento, il valore restituito e il ripristino senza input interattivo.
Esempi
#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';
}
Risultato
true true 42
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.