Fonctions de la bibliothèque C -vprintf()
Bibliothèque standard C - <stdio.h>
Description
Fonctions de la bibliothèque Cint vprintf(const char *format, va_list arg)Envoie une sortie formatée vers le flux de sortie standard stdout en utilisant une liste de paramètres.
Déclaration
Voici la déclaration de la fonction vprintf().
int vprintf(const char *format, va_list arg)
Paramètre
- format-- Il s'agit de la chaîne contenant le texte à écrire dans le flux de sortie standard stdout. 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 formatées selon les besoins. Les propriétés des balises de format sont : %[flags][width][.precision][length]specifierL'explication détaillée est la suivante :
| spécificateur | Sortie |
|---|---|
| c | Caractère |
| d ou i | Entier décimal signé |
| e | Notation scientifique utilisant le caractère e (mantisse et exposant) |
| E | Notation scientifique utilisant le caractère E (mantisse et exposant) |
| f | nombre à virgule flottante décimal |
| g | Sélectionne automatiquement la représentation appropriée entre %e et %f |
| G | Sélectionne automatiquement la représentation appropriée entre %E et %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 |
|---|---|
| - | Aligne la sortie à gauche dans la largeur de champ donnée ; par défaut, l'alignement est à droite (voir le sous-spécificateur de largeur). |
| + | Force l'apparition d'un signe plus ou moins (+ ou -) avant le résultat, c'est-à-dire que les nombres positifs afficheront un signe +. Par défaut, seuls les nombres négatifs sont précédés d'un signe -. |
| (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, s'il n'y a aucun chiffre après le point décimal, le point décimal n'est pas affiché. Lorsqu'il est utilisé avec g ou G, le résultat est le même qu'avec e ou E, mais les zéros de fin ne sont pas supprimés. |
| 0 | Place des zéros (0) à gauche des chiffres utilisés pour le remplissage, au lieu d'espaces (voir le sous-spécificateur de largeur). |
| width | Description |
|---|---|
| (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 ne sera 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. |
| .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 en tête. Si la valeur écrite est plus longue que ce nombre, le résultat ne sera 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 décimaux à afficher après le point 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, elle vaut 1 par défaut. 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. |
| 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'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). |
| 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, elle renvoie le nombre total de caractères écrits ; sinon, elle renvoie un nombre négatif.
Exemple
L'exemple suivant illustre l'utilisation de la fonction vprintf().
Exemple
#include <stdio.h>
#include <stdarg.h>
void WriteFrmtd(char *format, ...)
{
va_list args;
va_start(args, format);
vprintf(format, args);
va_end(args);
}
int main ()
{
WriteFrmtd("%d variable argument\n", 1);
WriteFrmtd("%d variable %s\n", 2, "arguments");
return(0);
}
#include <stdarg.h>
void WriteFrmtd(char *format, ...)
{
va_list args;
va_start(args, format);
vprintf(format, args);
va_end(args);
}
int main ()
{
WriteFrmtd("%d variable argument\n", 1);
WriteFrmtd("%d variable %s\n", 2, "arguments");
return(0);
}
Compilons et exécutons le programme ci-dessus, ce qui produira le résultat suivant :
1 variable argument 2 variable argumentsautres extensions