Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::endl — nowa linia i opróżnienie bufora strumienia

std::endl wstawia znak nowej linii i wywołuje flush() dla strumienia wyjściowego. W odróżnieniu od '\n' jawnie żąda synchronizacji bufora; używaj go wtedy, gdy potrzebujesz obu operacji.

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

Składnia

os << std::endl;
// Equivalent calls:
os.put(os.widen('\n'));
os.flush();

std::endl to manipulator strumienia wyjściowego zadeklarowany w <ostream>. Typowy zapis to os << std::endl, bez nawiasów po nazwie manipulatora. Jest szablonem funkcji obsługującym różne typy znaków strumienia.

Wykonuje kolejno os.put(os.widen('\n')) i os.flush(), po czym zwraca os. widen dostosowuje znak do typu znakowego strumienia. Zwracana referencja pozwala kontynuować łańcuch operacji <<.

'\n' oznacza znak nowej linii; samo jego wstawienie nie żąda jawnie opróżnienia bufora. std::flush żąda opróżnienia bufora bez dodawania nowej linii. Jeśli potrzebujesz tylko podziału wiersza, wybierz '\n', aby nie wymuszać dodatkowej synchronizacji przy każdym wierszu.

flush() synchronizuje bufor strumienia; nie jest gwarancją trwałego zapisu danych na dysku. Operacje wyjściowe mogą się nie powieść, ustawić stan błędu i — zależnie od maski wyjątków — zgłosić wyjątek. Przykład sprawdza stan std::cout, ale sam widoczny tekst nie dowodzi, kiedy nastąpiło opróżnienie bufora.

Przykłady

#include <iostream>

int main() {
    std::cout << "Ready" << std::endl;
    std::cout << "Done\n";
    return std::cout ? 0 : 1;
}

Wynik

Ready
Done

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła