Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::basic_ios::tie — svázání streamu s výstupním streamem

std::basic_ios::tie zjišťuje nebo mění svázaný výstupní stream. Vazba umožňuje před vstupem vyprázdnit jeho buffer; nullptr vazbu odstraní a nastavovací přetížení vrací předchozí ukazatel.

Verze: 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 má dvě přetížení. tie() vrací ukazatel na svázaný výstupní stream, nebo nullptr. tie(tiestr) nastaví ukazatel a vrátí předchozí hodnotu, nikoli novou. Typy charT a traits obou streamů musí souhlasit.

Když je vstupní stream v dobrém stavu, jeho objekt sentry, který připravuje čtení, zavolá flush() na svázaném výstupním streamu. Standard dovoluje toto volání vynechat, pokud je oblast pro zápis prázdná, a odložit je až do underflow(); pokud k volání nikdy nedojde, může se vyprázdnění zcela vynechat.

Ve výchozím nastavení je std::cin svázán s std::cout, což pomáhá zobrazit výzvu před čekáním na vstup. std::cin.tie(nullptr) tuto vazbu odstraní; případné potřebné vyprázdnění pak musíte zajistit výslovně. Samotné nastavení vazby flush() nevolá.

Nevytvářejte svázání streamu se sebou samým ani nepřímé cykly: porušují předběžnou podmínku a vedou k nedefinovanému chování. Svázaný objekt musí zůstat živý po dobu používání jeho ukazatele. Příklad ověřuje svázání, návratovou hodnotu a obnovení bez interaktivního vstupu.

Příklady

#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';
}

Výsledek

true
true
42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje