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

CKTIS / C++

std::ofstream — zápis do souboru

std::ofstream z <fstream> zapisuje data do souboru pomocí proudového rozhraní. Seznamte se s výchozím nahrazením obsahu, připojováním na konec a kontrolou chyb při otevření, zápisu a zavření souboru.

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

Syntaxe

#include <fstream>
std::ofstream out("file.txt");
out << "text\n";
out.close();

std::ofstream z <fstream> je alias pro std::basic_ofstream<char>. Poskytuje výstupní proud připojený k souboru; operátor << provádí formátovaný výstup. Objekt lze přesouvat, ale nelze jej kopírovat.

Konstruktor, který přijímá cestu, se ihned pokusí soubor otevřít. Výchozí std::ios::out soubor vytvoří, pokud je to možné, nebo odstraní obsah již existujícího souboru. std::ios::trunc toto odstranění výslovně vyjadřuje. Chcete-li připojovat data, použijte std::ios::app, který směruje každý zápis na konec souboru. std::ios::ate nastaví pozici na konec až po otevření; připojování nenahrazuje. std::ios::binary zvolí binární režim, ale nezmění << na přímý zápis reprezentace objektu.

Po otevření a po zápisu i zavření kontrolujte stav pomocí if (!out). is_open() oznamuje, zda je připojen otevřený soubor, nikoli zda všechny zápisy uspěly. Ve výchozím nastavení se chyby proudu oznamují stavovými příznaky; výjimky lze zapnout pomocí exceptions(). Výstup se ukládá do vyrovnávací paměti: chyba se může projevit až při jejím vyprázdnění nebo při volání close().

Při zničení objektu se soubor automaticky zavře prostřednictvím jeho vyrovnávací paměti. Výslovné zavolání close() umožňuje zkontrolovat chybu při zavírání, než proud přestane existovat. Příklad přepíše cktis-ofstream-example.txt v aktuálním pracovním adresáři a vypíše saved až po kontrole stavu po zavření. Používá funkce dostupné v C++23; odkazovaný dokument je průběžně se vyvíjející návrh standardu, nikoli konečné vydání C++23.

Pří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ýsledek

saved

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