CKTIS / C++
std::basic_ios::tie — lier un flux à un flux de sortie
std::basic_ios::tie consulte ou modifie le flux de sortie lié. Cette liaison permet de vider son tampon avant une lecture ; nullptr la supprime, et la surcharge qui la définit renvoie l’ancien pointeur.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
std::basic_ostream<charT, traits>* tie() const;
std::basic_ostream<charT, traits>* tie(std::basic_ostream<charT, traits>* tiestr);std::basic_ios::tie possède deux surcharges. tie() renvoie le pointeur vers le flux de sortie lié, ou nullptr. tie(tiestr) définit le pointeur et renvoie l’ancienne valeur, et non la nouvelle. Les types charT et traits des deux flux doivent correspondre.
Lorsqu’un flux d’entrée est dans un état valide, son objet sentry, qui prépare la lecture, appelle flush() sur le flux de sortie lié. La norme permet de supprimer cet appel si la zone d’écriture est vide et de le différer jusqu’à underflow() ; si cet appel n’a jamais lieu, le vidage peut être entièrement omis.
Par défaut, std::cin est lié à std::cout, ce qui aide à afficher une invite avant d’attendre une entrée. std::cin.tie(nullptr) supprime cette liaison ; il faut alors prévoir explicitement tout vidage nécessaire. Le simple fait de définir une liaison n’appelle pas flush().
Ne créez ni liaison d’un flux avec lui-même ni cycles indirects : ils violent la précondition et entraînent un comportement indéfini. L’objet lié doit rester vivant tant que son pointeur est utilisé. L’exemple vérifie la liaison, la valeur renvoyée et le rétablissement, sans entrée interactive.
Exemples
#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';
}
Résultat
true true 42
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.