CKTIS / C++
std::basic_ios::tie — powiązanie strumienia ze strumieniem wyjściowym
std::basic_ios::tie odczytuje lub zmienia powiązany strumień wyjściowy. Powiązanie pozwala opróżniać jego bufor przed odczytem; nullptr usuwa powiązanie, a przeciążenie ustawiające zwraca poprzedni wskaźnik.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
std::basic_ostream<charT, traits>* tie() const;
std::basic_ostream<charT, traits>* tie(std::basic_ostream<charT, traits>* tiestr);std::basic_ios::tie ma dwa przeciążenia. tie() zwraca wskaźnik powiązanego strumienia wyjściowego albo nullptr. tie(tiestr) ustawia wskaźnik i zwraca poprzednią wartość, nie nową. Typy charT i traits obu strumieni muszą być zgodne.
Gdy strumień wejściowy jest w dobrym stanie, jego obiekt sentry przygotowujący odczyt wywołuje flush() powiązanego wyjścia. Standard dopuszcza pominięcie tego wywołania przy pustym obszarze zapisu oraz odroczenie go do underflow(); jeśli takie wywołanie nie nastąpi, opróżnienie może zostać całkiem pominięte.
Domyślnie std::cin jest powiązany ze std::cout, co pomaga wyświetlić komunikat przed oczekiwaniem na dane. std::cin.tie(nullptr) usuwa to powiązanie; potrzebne opróżnianie trzeba wtedy zapewnić jawnie. Samo ustawienie powiązania nie wykonuje flush().
Nie twórz powiązań ze sobą ani cykli pośrednich: naruszają warunek wstępny i prowadzą do niezdefiniowanego zachowania. Powiązany obiekt musi pozostać żywy podczas używania wskaźnika. Przykład sprawdza ustawienie, wartość zwracaną i przywrócenie powiązania bez interaktywnego wejścia.
Przykłady
#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';
}
Wynik
true true 42
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.