CKTIS / C++
std::basic_ios::tie — vincular un flujo a un flujo de salida
std::basic_ios::tie consulta o cambia el flujo de salida vinculado. La vinculación permite vaciar su búfer antes de leer; nullptr la elimina y la sobrecarga que la establece devuelve el puntero anterior.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
std::basic_ostream<charT, traits>* tie() const;
std::basic_ostream<charT, traits>* tie(std::basic_ostream<charT, traits>* tiestr);std::basic_ios::tie tiene dos sobrecargas. tie() devuelve el puntero al flujo de salida vinculado o nullptr. tie(tiestr) establece el puntero y devuelve el valor anterior, no el nuevo. Los tipos charT y traits de ambos flujos deben coincidir.
Cuando un flujo de entrada está en buen estado, su objeto sentry, que prepara la lectura, llama a flush() en el flujo de salida vinculado. El estándar permite omitir esta llamada si el área de escritura está vacía y aplazarla hasta underflow(); si la llamada nunca se produce, el vaciado puede omitirse por completo.
De forma predeterminada, std::cin está vinculado a std::cout, lo que ayuda a mostrar un mensaje antes de esperar la entrada. std::cin.tie(nullptr) elimina esta vinculación; entonces hay que disponer explícitamente cualquier vaciado necesario. Establecer una vinculación por sí solo no llama a flush().
No crees vinculaciones de un flujo consigo mismo ni ciclos indirectos: incumplen la precondición y provocan comportamiento indefinido. El objeto vinculado debe seguir existiendo mientras se use su puntero. El ejemplo comprueba la vinculación, el valor devuelto y su restauración, sin entrada interactiva.
Ejemplos
#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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.