Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::ofstream — écrire dans un fichier

std::ofstream de <fstream> écrit des données dans un fichier au moyen d’une interface de flux. Découvrez le remplacement du contenu par défaut, l’ajout à la fin et la vérification des erreurs lors de l’ouverture, de l’écriture et de la fermeture.

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

Syntaxe

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

std::ofstream de <fstream> est un alias de std::basic_ofstream<char>. Il fournit un flux de sortie associé à un fichier ; l’opérateur << effectue une sortie formatée. L’objet peut être déplacé, mais pas copié.

Un constructeur qui reçoit un chemin tente immédiatement d’ouvrir le fichier. Par défaut, std::ios::out crée le fichier si possible ou supprime le contenu d’un fichier existant. std::ios::trunc exprime explicitement cette suppression. Pour ajouter du contenu, utilisez std::ios::app, qui dirige chaque écriture à la fin du fichier. std::ios::ate place la position à la fin uniquement après l’ouverture ; ce n’est pas un substitut à l’ajout. std::ios::binary sélectionne le mode binaire, mais ne transforme pas << en écriture brute de la représentation d’un objet.

Vérifiez l’état avec if (!out) après l’ouverture, puis après l’écriture et la fermeture. is_open() indique qu’un fichier ouvert est associé au flux, et non que toutes les écritures ont réussi. Par défaut, les erreurs du flux sont signalées par des indicateurs d’état ; vous pouvez activer les exceptions avec exceptions(). La sortie est mise en tampon : une erreur peut ne devenir visible qu’au vidage du tampon ou lors de l’appel à close().

La destruction de l’objet ferme automatiquement le fichier par l’intermédiaire de son tampon. Un appel explicite à close() permet de vérifier une erreur de fermeture avant que le flux cesse d’exister. L’exemple écrase cktis-ofstream-example.txt dans le répertoire de travail courant et n’affiche saved qu’après avoir vérifié l’état à la suite de la fermeture. Il utilise des fonctionnalités disponibles en C++23 ; le document lié est un projet de norme en évolution, pas une édition C++23 figée.

Exemples

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

Résultat

saved

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources