CKTIS / C++
std::endl — nova linha e esvaziamento do buffer do fluxo
std::endl insere uma nova linha e chama flush() num fluxo de saída. Ao contrário de '\n', pede explicitamente a sincronização do buffer; utilize-o quando precisar das duas operações.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
os << std::endl;
// Equivalent calls:
os.put(os.widen('\n'));
os.flush();std::endl é um manipulador de fluxos de saída declarado em <ostream>. A forma habitual é os << std::endl, sem parênteses após o nome do manipulador. É um modelo de função que suporta diferentes tipos de caracteres de fluxo.
Chama os.put(os.widen('\n')) e, em seguida, os.flush(), devolvendo depois os. widen adapta o carácter ao tipo de caracteres do fluxo. A referência devolvida permite encadear mais operações <<.
'\n' representa um carácter de nova linha; inseri-lo não pede explicitamente, por si só, o esvaziamento do buffer. std::flush pede o esvaziamento sem acrescentar uma nova linha. Se precisar apenas de uma mudança de linha, escolha '\n' para evitar forçar uma sincronização adicional em cada linha.
flush() sincroniza o buffer do fluxo; não garante o armazenamento permanente dos dados no disco. As operações de saída podem falhar, definir um estado de erro e — dependendo da máscara de exceções — lançar uma exceção. O exemplo verifica o estado de std::cout, mas o texto visível, por si só, não permite saber quando ocorreu o esvaziamento.
Exemplos
#include <iostream>
int main() {
std::cout << "Ready" << std::endl;
std::cout << "Done\n";
return std::cout ? 0 : 1;
}
Resultado
Ready Done
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.