CKTIS / C++
std::basic_ios::tie — ligar um fluxo a um fluxo de saída
std::basic_ios::tie consulta ou altera o fluxo de saída ligado. A ligação permite esvaziar o respetivo buffer antes da leitura; nullptr remove-a e a sobrecarga que a define devolve o ponteiro anterior.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
std::basic_ostream<charT, traits>* tie() const;
std::basic_ostream<charT, traits>* tie(std::basic_ostream<charT, traits>* tiestr);std::basic_ios::tie tem duas sobrecargas. tie() devolve o ponteiro para o fluxo de saída ligado ou nullptr. tie(tiestr) define o ponteiro e devolve o valor anterior, não o novo. Os tipos charT e traits dos dois fluxos têm de coincidir.
Quando um fluxo de entrada está num estado válido, o respetivo objeto sentry, que prepara a leitura, chama flush() no fluxo de saída ligado. A norma permite suprimir esta chamada se a área de escrita estiver vazia e adiá-la até underflow(); se a chamada nunca ocorrer, o esvaziamento pode ser totalmente omitido.
Por predefinição, std::cin está ligado a std::cout, o que ajuda a apresentar uma mensagem antes de aguardar a entrada. std::cin.tie(nullptr) remove esta ligação; nesse caso, é necessário assegurar explicitamente qualquer esvaziamento necessário. Definir uma ligação, por si só, não chama flush().
Não crie ligações de um fluxo a si próprio nem ciclos indiretos: violam a pré-condição e conduzem a comportamento indefinido. O objeto ligado tem de continuar vivo enquanto o respetivo ponteiro for utilizado. O exemplo verifica a ligação, o valor devolvido e o restauro, sem entrada interativa.
Exemplos
#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';
}
Resultado
true true 42
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.