CKTIS / C++
std::endl — nova vrstica in praznjenje medpomnilnika toka
std::endl vstavi novo vrstico in na izhodnem toku pokliče flush(). Za razliko od '\n' izrecno zahteva sinhronizacijo medpomnilnika; uporabi ga, kadar potrebuješ obe operaciji.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
os << std::endl;
// Equivalent calls:
os.put(os.widen('\n'));
os.flush();std::endl je manipulator izhodnega toka, deklariran v <ostream>. Običajni zapis je os << std::endl, brez oklepajev za imenom manipulatorja. Gre za predlogo funkcije, ki podpira različne znakovne tipe tokov.
Pokliče os.put(os.widen('\n')) in nato os.flush(), zatem pa vrne os. widen prilagodi znak znakovnemu tipu toka. Vrnjena referenca omogoča veriženje nadaljnjih operacij <<.
'\n' označuje znak za novo vrstico; njegova vstavitev sama po sebi izrecno ne zahteva praznjenja medpomnilnika. std::flush zahteva praznjenje, ne da bi dodal novo vrstico. Če potrebuješ samo prelom vrstice, izberi '\n', da se izogneš vsiljevanju dodatne sinhronizacije za vsako vrstico.
flush() sinhronizira medpomnilnik toka; ne zagotavlja trajnega shranjevanja podatkov na disk. Izhodne operacije lahko spodletijo, nastavijo stanje napake in — odvisno od maske izjem — sprožijo izjemo. Primer preveri stanje std::cout, vendar samo vidno besedilo ne pokaže, kdaj je prišlo do praznjenja.
Primeri
#include <iostream>
int main() {
std::cout << "Ready" << std::endl;
std::cout << "Done\n";
return std::cout ? 0 : 1;
}
Rezultat
Ready Done
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.