Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::endl — nový řádek a vyprázdnění vyrovnávací paměti proudu

std::endl vloží nový řádek a zavolá flush() na výstupním proudu. Na rozdíl od '\n' výslovně požaduje synchronizaci vyrovnávací paměti; použijte ho, když potřebujete obě operace.

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

Syntaxe

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

std::endl je manipulátor výstupního proudu deklarovaný v <ostream>. Obvyklý zápis je os << std::endl, bez závorek za názvem manipulátoru. Jde o šablonu funkce podporující různé znakové typy proudů.

Volá os.put(os.widen('\n')) a poté os.flush(), načež vrací os. widen přizpůsobí znak znakovému typu proudu. Vrácená reference umožňuje řetězit další operace <<.

'\n' označuje znak nového řádku; jeho vložení samo o sobě výslovně nepožaduje vyprázdnění vyrovnávací paměti. std::flush vyprázdnění požaduje, ale nepřidává nový řádek. Pokud potřebujete pouze zalomení řádku, zvolte '\n', abyste nevynucovali dodatečnou synchronizaci pro každý řádek.

flush() synchronizuje vyrovnávací paměť proudu; nezaručuje trvalé uložení dat na disk. Výstupní operace mohou selhat, nastavit chybový stav a — v závislosti na masce výjimek — vyvolat výjimku. Příklad kontroluje stav std::cout, ale ze samotného viditelného textu nelze určit, kdy k vyprázdnění došlo.

Příklady

#include <iostream>

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

Výsledek

Ready
Done

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje