Fonction de bibliothèque Cvfprintf()
Bibliothèque standard C - <stdio.h>
Description
Fonctions de bibliothèque Cint vfprintf(FILE *stream, const char *format, va_list arg)Envoie une sortie formatée vers le flux en utilisant une liste d'arguments.
Déclaration
Voici la déclaration de la fonction vfprintf().
int vfprintf(FILE *stream, const char *format, va_list arg)
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 sont remplacées par les valeurs spécifiées dans les arguments supplémentaires suivants et formatées selon les besoins. Les attributs des balises de format sont : %[flags][width][.precision][length]specifier, l'explication spécifique est la suivante :
| spécificateur | Sortie |
|---|---|
| c | Caractère |
| d ou i | entier décimal signé |
| e | Notation scientifique (mantisse et exposant) en utilisant le caractère e |
| E | Notation scientifique (mantisse et exposant) en utilisant le caractère E |
| f | nombre à virgule flottante décimal |
| g | Sélectionne automatiquement la représentation appropriée parmi %e ou %f |
| G | Sélectionne automatiquement la représentation appropriée parmi %E ou %f |
| o | octal signé |
| s | chaîne de caractères |
| u | entier décimal non signé |
| x | entier hexadécimal non signé |
| X | Entier hexadécimal non signé (lettres majuscules) |
| p | Adresse de pointeur |
| n | Aucune sortie |
| % | Caractère |
| indicateurs | Description |
|---|---|
| - | Justification à gauche dans la largeur de champ donnée ; par défaut, la justification est à 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 que les nombres positifs afficheront un signe + devant. Par défaut, seuls les nombres négatifs affichent un signe - devant. |
| (espace) | Si aucun signe n'est écrit, un espace est inséré 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 et f, il force la sortie à contenir un point décimal même s’il n’y a aucun chiffre après. Par défaut, le point décimal n’est pas affiché s’il n’y a aucun chiffre qui le suit. 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. |
| 0 | Pour un remplissage spécifié, placez des zéros (0) à gauche du nombre au lieu d’espaces (voir le sous-spécificateur de largeur). |
| width | Description |
|---|---|
| (nombre) | Nombre minimum de caractères à afficher. Si la valeur de sortie contient moins de caractères que ce nombre, le résultat est complété par des espaces. Si la valeur de sortie contient plus de caractères 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 placée comme argument entier supplémentaire avant l’argument à formater. |
| .precision | Description |
|---|---|
| .number | Pour 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 placée comme argument entier supplémentaire avant l’argument à formater. |
| longueur | Description |
|---|---|
| h | L'argument est interprété comme un short int ou un unsigned short int (ne s'applique qu'aux spécificateurs d'entiers : i, d, o, u, x et X). |
| l | L’argument est interprété comme un long int ou un unsigned long int, applicable aux spécificateurs d’entier (i, d, o, u, x et X) et aux spécificateurs c (indiquant un caractère large) et s (indiquant une chaîne de caractères larges). |
| L | L'argument est interprété comme un long double (ne s'applique qu'aux spécificateurs à virgule flottante : e, E, f, g et G). |
- arg-- Un objet représentant la liste d’arguments variables. Il doit être initialisé avec la macro va_start définie dans <stdarg>.
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 vfprintf().
#include <stdio.h>
#include <stdarg.h>
void WriteFrmtd(FILE *stream, char *format, ...)
{
va_list args;
va_start(args, format);
vfprintf(stream, format, args);
va_end(args);
}
int main ()
{
FILE *fp;
fp = fopen("file.txt","w");
WriteFrmtd(fp, "This is just one argument %d \n", 10);
fclose(fp);
return(0);
}
Compilons et exécutons le programme ci-dessus, qui ouvrira le fichier dans le répertoire courantfile.txt, et écrira le contenu suivant :
This is just one argument 10
Maintenant, utilisons le programme suivant pour afficher le contenu du fichier ci-dessus :
#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);
}
autres extensions