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

CKTIS / C++

std::ios_base::sync_with_stdio — sincronização dos fluxos C++ e C

std::ios_base::sync_with_stdio controla a sincronização entre os fluxos padrão de C++ e os fluxos da biblioteca C. Chamá-la com false permite que funcionem de forma independente; a função devolve o estado anterior, não um indicador de sucesso.

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

Sintaxe

static bool sync_with_stdio(bool sync = true);

std::ios_base::sync_with_stdio é uma função estática que controla a sincronização entre os fluxos padrão de C++ e os fluxos C correspondentes, como std::cout e stdout. Inicialmente, a sincronização está ativada. O argumento false permite que os fluxos funcionem de forma independente; true, que também é o valor predefinido quando o argumento é omitido, pede a sincronização.

O valor devolvido do tipo bool descreve o estado anterior, não se a operação foi bem-sucedida: true significa que a sincronização estava ativada anteriormente. A primeira chamada devolve true. Por isso, uma chamada sem argumento não é uma consulta passiva à definição.

Define o modo antes de qualquer operação de entrada ou saída nos fluxos padrão. Depois de uma operação deste tipo, o efeito da chamada é definido pela implementação, incluindo uma tentativa de voltar a ativar a sincronização. Com a sincronização ativada, é possível intercalar operações nos fluxos C++ e C correspondentes; depois de a desativar, não assumas que esta garantia se mantém.

Desativar a sincronização não garante um aumento de velocidade: a norma especifica a independência dos fluxos, não o tempo de execução. O exemplo altera a definição antes da primeira saída, apresenta o estado anterior como 1 e, em seguida, a soma calculada. Não mistura operações de saída de C e C++.

Exemplos

#include <iostream>

int main() {
    const bool previous = std::ios_base::sync_with_stdio(false);
    std::cout << "previous=" << previous << '\n';
    std::cout << "sum=" << (20 + 22) << '\n';
}

Resultado

previous=1
sum=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