Langage de programmation - C - Référence des fonctions

FPUTS	Chaîne à mettre dans le fichier
Langage C	stdio.h

Syntaxe

int fputs(const *str,FILE *ptrfichier);

Paramètres

Nom	Description
ptrfichier	Ce paramètre permet d'indiquer l'identificateur de fichier
str	Ce paramètre permet d'indiquer la chaîne de caractères à écrire

Description

Cette fonction effectue l'écriture d'une chaîne de caractères dans un fichier.

Algorithme

MODULE FPUTS(string, file)
   SI file est NULL ALORS
      RETOURNE Erreur "Fichier non ouvert"
   FIN SI
   SI le fichier n'est pas accessible en mode écriture ALORS
      RETOURNE Erreur "Le fichier n'est pas en mode écriture"
   FIN SI
   BOUCLE POUR CHAQUE caractère dans string FAIRE
      Essayer d'écrire le caractère dans le file :
         SI l'écriture échoue ALORS
            RETOURNE EOF (indiquant une erreur)
         FIN SI
   FIN BOUCLE POUR CHAQUE
   RETOURNE 0 * indiquant un succès

Remarques

Écriture de chaînes dans un fichier : La fonction fputs est utilisée pour écrire une chaîne de caractères (terminée par un caractère nul) dans un fichier. Contrairement à fprintf, elle n'effectue pas de formatage des données, ce qui en fait une solution plus rapide pour écrire directement des chaînes simples.
Ne pas ajouter automatiquement de retour à la ligne : fputs écrit exactement la chaîne de caractères fournie sans ajouter de caractère de retour à la ligne à la fin. Si un retour à la ligne est nécessaire, il doit être explicitement inclus dans la chaîne passée à la fonction.
Retourne un indicateur de succès ou d'échec : La fonction retourne un entier : une valeur non négative indique que l'écriture a réussi, tandis qu'une valeur négative indique une erreur. Il est important de vérifier cette valeur pour s'assurer que l'écriture dans le fichier a bien été effectuée.
Dépendance au flux fourni : fputs écrit les données dans le flux spécifié, pouvant être un fichier ouvert en écriture, comme stdout ou un fichier créé avec fopen. Si le fichier n'est pas ouvert correctement ou si les permissions ne permettent pas l'écriture, l'appel échouera.
Utilisation efficace pour les chaînes statiques ou constantes : fputs est particulièrement utile pour écrire des chaînes prédéfinies ou constantes, car elle évite le surcoût du formatage que pourrait entraîner l'utilisation de fprintf. Cependant, elle est moins flexible lorsque des données dynamiques doivent être écrites.
Gestion des tampons : Comme pour toutes les fonctions de la bibliothèque standard C, fputs utilise un tampon pour optimiser les écritures. Cela signifie que les données peuvent ne pas être immédiatement écrites dans le fichier. Pour forcer l'écriture, il est nécessaire d'appeler fflush sur le flux concerné.
Risques liés à une chaîne non terminée : Si la chaîne passée à fputs n'est pas correctement terminée par un caractère nul, la fonction continuera à écrire au-delà de la fin prévue de la chaîne de caractères, ce qui peut entraîner un comportement indéfini et compromettre la sécurité ou la stabilité de l'application.

Exemple

Voici un exemple typique de l'utilisation de cette fonction :

Essayer maintenant !


				
#include <stdio.h>

#include <stdlib.h>

 
int main()


{

    FILE * Handle = fopen("monfichier.txt", "w");


    if(Handle != NULL) {

        fputs("Gladir.com",Handle);


        fclose(Handle);

    }

    return 0;

}

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

Gladir.com

Voir également

Langage de programmation - C - Référence de procédures et fonctions - fgets
Langage de programmation - C - Référence de procédures et fonctions - gets
Langage de programmation - C - Référence de procédures et fonctions - puts
Langage de programmation - C++ - Référence de procédures et fonctions - fputs

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 110.

Dernière mise à jour : Mardi, le 28 juillet 2015

Section courante

A propos

Section administrative du site

FPUTS