KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::ofstream — naar een bestand schrijven

std::ofstream uit <fstream> schrijft gegevens naar een bestand via een streaminterface. Lees meer over het standaard vervangen van inhoud, toevoegen aan het einde en het controleren op fouten bij het openen, schrijven en sluiten.

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

Syntax

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

std::ofstream uit <fstream> is een alias voor std::basic_ofstream<char>. Het biedt een uitvoerstream die aan een bestand is gekoppeld; operator << voert geformatteerde uitvoer uit. Het object kan worden verplaatst, maar niet gekopieerd.

Een constructor die een pad ontvangt, probeert het bestand meteen te openen. Standaard maakt std::ios::out het bestand aan als dat mogelijk is, of verwijdert het de inhoud van een bestaand bestand. std::ios::trunc drukt die verwijdering expliciet uit. Gebruik std::ios::app om gegevens toe te voegen; daarmee wordt elke schrijfactie naar het einde van het bestand gestuurd. std::ios::ate zet de positie alleen na het openen aan het einde; het is geen alternatief voor toevoegen. std::ios::binary selecteert de binaire modus, maar maakt van << geen onbewerkte schrijfopdracht voor de representatie van een object.

Controleer de status met if (!out) na het openen en na het schrijven en sluiten. is_open() geeft aan dat er een geopend bestand is gekoppeld, niet dat alle schrijfacties zijn geslaagd. Standaard worden streamfouten gemeld via statusvlaggen; uitzonderingen kun je inschakelen met exceptions(). Uitvoer wordt gebufferd: een fout wordt mogelijk pas zichtbaar bij het leegmaken van de buffer of bij close().

Bij het vernietigen van het object wordt het bestand automatisch via de buffer gesloten. Met een expliciete aanroep van close() kun je controleren op een sluitfout voordat de stream niet meer bestaat. Het voorbeeld overschrijft cktis-ofstream-example.txt in de huidige werkmap en drukt saved pas af nadat de status na het sluiten is gecontroleerd. Het gebruikt functies die beschikbaar zijn in C++23; het gekoppelde document is een voortdurend bijgewerkt standaardontwerp, geen definitieve C++23-editie.

Voorbeelden

#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";
}

Resultaat

saved

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen