CKTIS / C++
std::ofstream — zápis do súboru
std::ofstream z <fstream> zapisuje údaje do súboru pomocou prúdového rozhrania. Zistite, ako funguje predvolené nahradenie obsahu, pripájanie na koniec a kontrola chýb pri otváraní, zapisovaní a zatváraní súboru.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <fstream>
std::ofstream out("file.txt");
out << "text\n";
out.close();std::ofstream z <fstream> je alias pre std::basic_ofstream<char>. Poskytuje výstupný prúd pripojený k súboru; operátor << vykonáva formátovaný výstup. Objekt možno presúvať, ale nie kopírovať.
Konštruktor, ktorý prijíma cestu, sa okamžite pokúsi súbor otvoriť. Predvolené std::ios::out súbor vytvorí, ak je to možné, alebo odstráni obsah už existujúceho súboru. std::ios::trunc toto odstránenie vyjadruje výslovne. Ak chcete pripájať údaje, použite std::ios::app, ktorý smeruje každý zápis na koniec súboru. std::ios::ate nastaví pozíciu na koniec až po otvorení; nenahrádza pripájanie. std::ios::binary zvolí binárny režim, ale nezmení << na priamy zápis reprezentácie objektu.
Po otvorení a po zápise aj zatvorení kontrolujte stav pomocou if (!out). is_open() oznamuje, či je pripojený otvorený súbor, nie či boli všetky zápisy úspešné. Predvolene sa chyby prúdu oznamujú stavovými príznakmi; výnimky možno zapnúť pomocou exceptions(). Výstup sa ukladá do vyrovnávacej pamäte: chyba sa môže prejaviť až pri jej vyprázdnení alebo pri volaní close().
Pri zničení objektu sa súbor automaticky zatvorí prostredníctvom jeho vyrovnávacej pamäte. Výslovné zavolanie close() umožňuje skontrolovať chybu pri zatváraní skôr, než prúd prestane existovať. Príklad prepíše cktis-ofstream-example.txt v aktuálnom pracovnom adresári a vypíše saved až po kontrole stavu po zatvorení. Používa funkcie dostupné v C++23; odkazovaný dokument je priebežne sa vyvíjajúci návrh štandardu, nie konečné vydanie C++23.
Príklady
#include <fstream>
#include <iostream>
int main() {
std::ofstream out("cktis-ofstream-example.txt",
std::ios::out | std::ios::trunc);
if (!out) {
std::cerr << "open failed\n";
return 1;
}
out << "Hello, file!\n";
out.close();
if (!out) {
std::cerr << "write or close failed\n";
return 1;
}
std::cout << "saved\n";
}
Výsledok
saved
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.