Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::basic_ios::tie — ligar um fluxo a um fluxo de saída

std::basic_ios::tie consulta ou altera o fluxo de saída ligado. A ligação permite esvaziar o respetivo buffer antes da leitura; nullptr remove-a e a sobrecarga que a define devolve o ponteiro anterior.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

std::basic_ostream<charT, traits>* tie() const;
std::basic_ostream<charT, traits>* tie(std::basic_ostream<charT, traits>* tiestr);

std::basic_ios::tie tem duas sobrecargas. tie() devolve o ponteiro para o fluxo de saída ligado ou nullptr. tie(tiestr) define o ponteiro e devolve o valor anterior, não o novo. Os tipos charT e traits dos dois fluxos têm de coincidir.

Quando um fluxo de entrada está num estado válido, o respetivo objeto sentry, que prepara a leitura, chama flush() no fluxo de saída ligado. A norma permite suprimir esta chamada se a área de escrita estiver vazia e adiá-la até underflow(); se a chamada nunca ocorrer, o esvaziamento pode ser totalmente omitido.

Por predefinição, std::cin está ligado a std::cout, o que ajuda a apresentar uma mensagem antes de aguardar a entrada. std::cin.tie(nullptr) remove esta ligação; nesse caso, é necessário assegurar explicitamente qualquer esvaziamento necessário. Definir uma ligação, por si só, não chama flush().

Não crie ligações de um fluxo a si próprio nem ciclos indiretos: violam a pré-condição e conduzem a comportamento indefinido. O objeto ligado tem de continuar vivo enquanto o respetivo ponteiro for utilizado. O exemplo verifica a ligação, o valor devolvido e o restauro, sem entrada interativa.

Exemplos

#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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes