FREOPEN

Syntaxe

Paramètres

Description

Cette fonction permet de fermer le fichier et de réouvrer un fichier en lui affectant un pointeur.

Remarques

• La fonction freopen() associe un flux de données existant à un fichier différent. Le nom du nouveau fichier est pointé par nomfichier, le mode d'accès est pointé par mode et le flux de données à réaffecter est pointé par ptrfichier. La chaîne de caractères de mode utilise le même format que la fonction fopen().
• Lorsqu'elle est appelé, la fonction freopen() essaie d'abord de fermer un fichier pouvant actuellement être associé à un flux de données. Cependant, si la tentative de fermeture du fichier échoue, la fonction freopen() continue toujours d'ouvrir l'autre fichier.
• La fonction freopen() renvoie un pointeur à diffuser en cas de succès et un pointeur null dans le cas contraire.
• L'utilisation principale de la fonction freopen() est de rediriger les fichiers définis par le système stdin (entrée standard), stdout (sortie standard) et stderr (sortie d'erreur standard) vers un autre fichier.
• Redirection des flux standards et des fichiers : La fonction freopen permet de réouvrir un fichier existant en modifiant l'association d'un flux (stdin, stdout, stderr ou un fichier ouvert avec fopen). Cela est utile pour rediriger l'entrée ou la sortie d'un programme, par exemple pour enregistrer des journaux de bord ou lire des entrées depuis un fichier plutôt que le clavier.
• Utilisation pour rediriger stdout vers un fichier : freopen est souvent utilisée pour rediriger stdout vers un fichier, permettant d'écrire les sorties du programme dans un fichier au lieu de l'écran :
1. freopen("output.txt", "w", stdout);
2. printf("Ce message sera écrit dans output.txt\n");
3. fclose(stdout);

Après cet appel, toutes les sorties utilisant printf ou cout seront envoyées au fichier output.txt.

• Redirection de stdin pour lire depuis un fichier : On peut aussi rediriger stdin pour lire des entrées depuis un fichier au lieu du clavier :
1. freopen("input.txt", "r", stdin);
2. char buffer[100];
3. scanf("%s", buffer);
4. printf("Lu depuis le fichier : %s\n", buffer);
5. fclose(stdin);

Cela est utile pour automatiser les tests d'un programme avec des fichiers d'entrée prédéfinis.

• Impact sur les flux standards (cout et cerr en C++) : freopen ne redirige pas automatiquement les flux C++ std::cout, std::cin et std::cerr. Pour rediriger ces flux, il faut utiliser la fonction std::ios::rdbuf() comme ceci :
1. std::ofstream file("output.txt");
2. std::streambuf *backup = std::cout.rdbuf(file.rdbuf());
3. std::cout << "Ceci sera écrit dans output.txt" << std::endl;
4. std::cout.rdbuf(backup); // Rétablir la sortie par défaut

Cela permet de rediriger la sortie de std::cout tout en gardant la possibilité de la restaurer.

• Fermeture automatique du flux d'origine : Lorsqu'un fichier est réouvert avec freopen, l'ancien fichier associé au FILE* est automatiquement fermé. Il n'est donc pas nécessaire d'appeler fclose sur le fichier d'origine avant d'utiliser freopen, ce qui simplifie la gestion des fichiers dans certains cas.
• Gestion des erreurs et vérification du retour : freopen peut échouer si le fichier n'existe pas ("r"), si le programme n'a pas les permissions nécessaires ou si le mode d'ouverture est invalide. Il est donc essentiel de vérifier le retour de la fonction :
1. if (freopen("output.txt", "w", stdout) == NULL) {
2.     perror("Erreur lors de la redirection");
3. }

Cela permet d'éviter des comportements indéfinis si la redirection échoue.

• Portabilité et alternatives : freopen est une fonction standard du C, mais son comportement peut varier légèrement selon les plateformes, notamment sous Windows et Linux. Une alternative en C++ est d'utiliser std::ofstream pour stdout et std::ifstream pour stdin, ce qui offre une meilleure portabilité et une intégration plus propre avec les flux C++.

Exemple

Voici un exemple montrant une utilisation plus classique de cette fonction :

Essayer maintenant !

on obtiendra le résultat suivant dans le fichier «monfichier.txt» :

Voir également

Langage de programmation - C++ - Référence de procédures et fonctions - fclose
Langage de programmation - C++ - Référence de procédures et fonctions - fopen
Langage de programmation - C - Référence de procédures et fonctions - freopen

Références

Langage C, Edition Micro-Application, Gehard Willms, 2001, ISBN: 2-7429-2008-0, page 731.
Borland C++ for Windows 4.0, Library Reference, Edition Borland, 1993, Part # BCP1240WW21772, page 112.