Fonctions de bibliothèque C -fprintf()

Bibliothèque standard C - <stdio.h>

Description

Fonctions de bibliothèque Cint fprintf(FILE *stream, const char *format, ...)Envoie la sortie formatée vers le flux.

Déclaration

Voici la déclaration de la fonction fprintf().

int fprintf(FILE *stream, const char *format, ...)

Paramètre

  • stream-- Il s'agit d'un pointeur vers un objet FILE qui identifie le flux.
  • format-- Il s'agit d'une chaîne C contenant le texte à écrire dans le flux. Elle peut contenir des balises de format intégrées, qui peuvent être remplacées par les valeurs spécifiées dans les arguments supplémentaires suivants et mises en forme selon les besoins. Les propriétés des balises de format sont : %[flags][width][.precision][length]specifier, l'explication spécifique est la suivante :
spécificateurSortie
cCaractère
d ou iEntier décimal signé
eNotation scientifique utilisant le caractère e (mantisse et exposant)
ENotation scientifique utilisant le caractère E (mantisse et exposant)
fnombre à virgule flottante décimal
gChoisir automatiquement la représentation appropriée entre %e et %f
GChoisir automatiquement la représentation appropriée entre %E et %f
ooctal signé
schaîne de caractères
uEntier décimal non signé
xEntier hexadécimal non signé
XEntier hexadécimal non signé (lettres majuscules)
pAdresse de pointeur
nAucune sortie
%Caractère

indicateursDescription
-Aligner à gauche dans la largeur de champ donnée ; la valeur par défaut est alignée à droite (voir le sous-spécificateur de largeur).
+Force l'affichage d'un signe plus ou moins (+ ou -) avant le résultat, c'est-à-dire qu'un signe + est affiché avant les nombres positifs. Par défaut, seuls les nombres négatifs ont un signe - affiché devant eux.
(espace)Si aucun signe n'est écrit, insérez un espace avant la valeur.
#Lorsqu'il est utilisé avec les spécificateurs o, x ou X, une valeur non nulle est précédée de 0, 0x ou 0X, respectivement.
Lorsqu'il est utilisé avec e, E, f, il force la sortie à contenir un point décimal, même s'il n'y a aucun chiffre après celui-ci. Par défaut, s'il n'y a aucun chiffre après celui-ci, le point décimal n'est pas affiché.
Lorsqu'il est utilisé avec g ou G, le résultat est le même que lors de l'utilisation de e ou E, mais les zéros de fin ne sont pas supprimés.
0Placez des zéros (0) à gauche du nombre lorsque le remplissage est spécifié, au lieu d'espaces (voir le sous-spécificateur de largeur).

widthDescription
(nombre)Le nombre minimum de caractères à afficher. Si la valeur de sortie est plus courte que ce nombre, le résultat est complété par des espaces. Si la valeur de sortie est plus longue que ce nombre, le résultat n'est pas tronqué.
*La largeur n'est pas spécifiée dans la chaîne de format, mais est fournie comme argument entier supplémentaire placé avant l'argument à formater.

.precisionDescription
.numberPour les spécificateurs d'entiers (d, i, o, u, x, X) : la précision spécifie le nombre minimum de chiffres à écrire. Si la valeur écrite est plus courte que ce nombre, le résultat est complété par des zéros de tête. Si la valeur écrite est plus longue que ce nombre, le résultat n'est pas tronqué. Une précision de 0 signifie qu'aucun caractère n'est écrit.
Pour les spécificateurs e, E et f : le nombre de chiffres à afficher après le séparateur décimal.
Pour les spécificateurs g et G : le nombre maximal de chiffres significatifs à afficher.
Pour s : le nombre maximal de caractères à afficher. Par défaut, tous les caractères sont affichés jusqu'à ce que le caractère nul de terminaison soit rencontré.
Pour le type c : n'a aucun effet.
Lorsqu'aucune précision n'est spécifiée, la valeur par défaut est 1. Si elle est spécifiée sans valeur explicite, elle est supposée être 0.
.*La précision n'est pas spécifiée dans la chaîne de format, mais est fournie comme argument de valeur entière supplémentaire placé avant l'argument à formater.

longueurDescription
hL'argument est interprété comme un entier court ou un entier court non signé (applicable uniquement aux spécificateurs d'entiers : i, d, o, u, x et X).
lL'argument est interprété comme un entier long ou un entier long non signé, applicable aux spécificateurs d'entiers (i, d, o, u, x et X) ainsi qu'aux spécificateurs c (indiquant un caractère large) et s (indiquant une chaîne de caractères larges).
LL'argument est interprété comme un long double (applicable uniquement aux spécificateurs de nombres à virgule flottante : e, E, f, g et G).
  • Arguments supplémentaires-- Selon la chaîne de format, la fonction peut nécessiter une série d'arguments supplémentaires, chacun contenant une valeur à insérer, remplaçant chaque balise % spécifiée dans le paramètre de format. Le nombre d'arguments doit être identique au nombre de balises %.

Valeur de retour

En cas de succès, le nombre total de caractères écrits est renvoyé ; sinon, un nombre négatif est renvoyé.

Exemple

L'exemple suivant illustre l'utilisation de la fonction fprintf().

Exemple

#include <stdio.h>
#include <stdlib.h>

int main()
{
   FILE * fp;

   fp = fopen ("file.txt", "w+");
   fprintf(fp, "%s %s %s %d", "We", "are", "in", 2014);
   
   fclose(fp);
   
   return(0);
}

Compilons et exécutons le programme ci-dessus, qui créera un fichierfile.txt, et son contenu est le suivant :

We are in 2014

Maintenant, utilisons le programme suivant pour afficher le contenu du fichier ci-dessus :

Exemple

#include <stdio.h>

int main ()
{
   FILE *fp;
   int c;

   fp = fopen("file.txt","r");
   while(1)
   {
      c = fgetc(fp);
      if( feof(fp) )
      {
          break ;
      }
      printf("%c", c);
   }
   fclose(fp);
   return(0);
}

Bibliothèque standard C - <stdio.h>

autres extensions