Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła