Fonctions de la bibliothèque C -vsprintf()

Bibliothèque standard C - <stdio.h>

Description

Fonctions de la bibliothèque Cint vsprintf(char *str, const char *format, va_list arg)Envoie une sortie formatée vers une chaîne en utilisant une liste d'arguments.

Déclaration

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

int vsprintf(char *str, const char *format, va_list arg)

Paramètre

  • str-- Il s'agit d'un pointeur vers un tableau de caractères qui stocke une chaîne C.
  • format-- Il s'agit d'une chaîne contenant le texte à écrire dans la chaîne str. 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é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
gChoisit automatiquement la représentation appropriée entre %e ou %f
GChoisit automatiquement la représentation appropriée entre %E ou %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
-Justifie à gauche dans la largeur de champ donnée ; par défaut, justifié à 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é devant les nombres positifs. Par défaut, seuls les nombres négatifs sont précédés d'un signe -.
(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 et f, force la sortie à contenir un point décimal, même si aucun chiffre ne suit. Par défaut, si aucun chiffre ne suit, 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 pour le remplissage 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 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.

.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 non significatifs. 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 à 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 short int ou un unsigned short int (applicable uniquement aux spécificateurs d'entiers : i, d, o, u, x et X).
lL'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) et aux spécificateurs c (désignant un caractère large) et s (désignant 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).
  • arg-- Un objet représentant une liste d'arguments variables. Il doit être initialisé par la macro va_start définie dans <stdarg>.

Valeur de retour

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

Exemple

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

#include <stdio.h>
#include <stdarg.h>

char buffer[80];
int vspfunc(char *format, ...)
{
   va_list aptr;
   int ret;

   va_start(aptr, format);
   ret = vsprintf(buffer, format, aptr);
   va_end(aptr);

   return(ret);
}

int main()
{
   int i = 5;
   float f = 27.0;
   char str[50] = "example.com";

   vspfunc("%d %f %s", i, f, str);
   printf("%s\n", buffer);
   
   return(0);
}

Compilons et exécutons le programme ci-dessus, ce qui produira le résultat suivant :

5 27.000000 example.com

Bibliothèque standard C - <stdio.h>

autres extensions