CKTIS / C++
std::ios_base::sync_with_stdio — synchronizacja strumieni C++ i C
std::ios_base::sync_with_stdio steruje synchronizacją standardowych strumieni C++ ze strumieniami biblioteki C. Wywołanie z false pozwala im działać niezależnie; funkcja zwraca poprzedni stan, a nie informację o powodzeniu.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
static bool sync_with_stdio(bool sync = true);std::ios_base::sync_with_stdio jest statyczną funkcją sterującą synchronizacją standardowych strumieni C++ z odpowiadającymi im strumieniami C, np. std::cout ze stdout. Początkowo synchronizacja jest włączona. Argument false pozwala strumieniom działać niezależnie; true, również domyślne przy pominięciu argumentu, żąda synchronizacji.
Wynik typu bool opisuje poprzedni stan, nie powodzenie operacji: true oznacza wcześniejszą synchronizację. Pierwsze wywołanie zwraca true. Wywołanie bez argumentu nie jest więc biernym odczytem ustawienia.
Ustaw tryb przed jakąkolwiek operacją wejścia lub wyjścia na standardowych strumieniach. Po takiej operacji efekt wywołania jest zależny od implementacji — dotyczy to także próby ponownego włączenia synchronizacji. Przy włączonej synchronizacji można przeplatać operacje na odpowiadających sobie strumieniach C++ i C; po jej wyłączeniu nie należy zakładać zachowania tej gwarancji.
Wyłączenie synchronizacji nie gwarantuje przyspieszenia: standard określa niezależność strumieni, nie czas wykonania. Przykład zmienia ustawienie przed pierwszym wyjściem, wypisuje poprzedni stan jako 1, a następnie obliczoną sumę. Nie miesza operacji wyjściowych C i C++.
Przykłady
#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';
}
Wynik
previous=1 sum=42
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.