Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::ios_base::sync_with_stdio — sincronizzazione degli stream C++ e C

std::ios_base::sync_with_stdio controlla la sincronizzazione tra gli stream standard C++ e gli stream della libreria C. Chiamarla con false consente loro di operare in modo indipendente; la funzione restituisce lo stato precedente, non un indicatore di successo.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

static bool sync_with_stdio(bool sync = true);

std::ios_base::sync_with_stdio è una funzione statica che controlla la sincronizzazione tra gli stream standard C++ e i corrispondenti stream C, per esempio tra std::cout e stdout. Inizialmente la sincronizzazione è attiva. L’argomento false consente agli stream di operare in modo indipendente; true, che è anche il valore predefinito se l’argomento viene omesso, richiede la sincronizzazione.

Il valore restituito di tipo bool descrive lo stato precedente, non indica se l’operazione è riuscita: true significa che la sincronizzazione era attiva in precedenza. La prima chiamata restituisce true. Una chiamata senza argomento, quindi, non è una semplice lettura dell’impostazione.

Imposta la modalità prima di qualsiasi operazione di input o output sugli stream standard. Dopo un’operazione di questo tipo, l’effetto della chiamata è definito dall’implementazione, anche quando si tenta di riattivare la sincronizzazione. Con la sincronizzazione attiva si possono alternare operazioni sugli stream C++ e C corrispondenti; dopo averla disattivata, non presumere che questa garanzia resti valida.

Disattivare la sincronizzazione non garantisce un aumento della velocità: lo standard specifica l’indipendenza degli stream, non il tempo di esecuzione. L’esempio modifica l’impostazione prima del primo output, stampa lo stato precedente come 1 e poi la somma calcolata. Non mescola operazioni di output C e C++.

Esempi

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

Risultato

previous=1
sum=42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti