Rechercher une page de manuel
stdarg
Langue: fr
Version: 14 octobre 2001 (mandriva - 01/05/08)
Section: 3 (Bibliothèques de fonctions)
NOM
stdarg, va_start, va_arg, va_copy, va_end - Liste variable d'argumentsSYNOPSIS
#include <stdarg.h>void va_start (va_list ap, last);
type va_arg (va_list ap, type);
void va_end (va_list ap); void va_copy (va_list dest, va_list src);
DESCRIPTION
Une fonction peut être appelée avec un nombre variable d'arguments, eux-mêmes de types variables. Une telle fonction est dite « variadique ». Le fichier d'en-tête <stdarg.h> déclare un type va_list et définit trois macros permettant de parcourir la liste d'arguments dont le nombre et les types ne sont pas connus par la fonction appelée.La fonction appelée doit déclarer un objet de type va_list utilisé par les macros va_start(), va_arg() et va_end().
va_start
La macro va_start() initialise ap pour les utilisations ultérieures de va_arg() et va_end(), et doit donc être appelée en premier.Le paramètre last est le nom du dernier paramètre avant la liste d'argument variable, c'est-à-dire le dernier paramètre dont la fonction connaisse le type.
Comme l'adresse de ce paramètre est utilisée dans la macro va_start(), il ne doit pas être déclaré comme une variable en registre, ni comme un type fonction ou tableau.
va_arg
La macro va_arg() se développe en une expression qui a le type et la valeur de l'argument suivant de l'appel. Le paramètre ap est la va_list ap initialisée par va_start(). Chaque appel de va_arg() modifie ap pour que l'appel suivant renvoie l'argument suivant. Le paramètre type est le nom du type, indiqué de telle manière qu'un pointeur sur un objet de ce type puisse être déclaré simplement en ajoutant un astérisque à type.La première utilisation de la macro va_arg() après celle de va_start() renvoie l'argument suivant last. Les invocations successives renvient les valeurs des arguments restants.
S'il n'y a pas d'argument suivant, ou si type n'est pas compatible avec le type réel du prochain argument, des erreurs imprévisibles se produiront.
Si ap est passé à une fonction qui utilise va_arg(ap,type) alors la valeur de ap est indéfinie après le retour de cette fonction.
va_end
À chaque invocation de va_start() doit correspondre une invocation de va_end() dans la même fonction. Après l'appel va_end(ap) la variable ap est indéfinie. Plusieurs traversées de la liste sont possible, à condition que chacune soit encadrée par va_start() et va_end(). va_end() peut être une macro ou une fonction.va_copy
Une implémentation évidente est de représenter va_list par un pointeur dans la pile de la fonction variadique. Dans une telle situation (de loin la plus courante), rien ne semble s'opposer à une affectation-
va_list aq = ap;
-
va_list aq; *aq = *ap;
-
va_list aq; va_copy(aq, ap); ... va_end(aq);
CONFORMITÉ
Les macros va_start(), va_arg() et va_end() sont conformes à C89. C99 définit la macro va_copy().NOTES
Ces macros ne sont PAS compatibles avec les anciennes macros qu'elles remplacent. Une compatibilité de version peut être obtenue en incluant le fichier d'en-tête varargs.h.La mise en oeuvre historique est :
#include <varargs.h> void foo(va_alist) va_dcl { va_list ap; va_start(ap); while(...) { ... x = va_arg(ap, type); ... } va_end(ap); }Sur certains systèmes, va_end() contient une accolade fermante « } » correspondant à l'accolade ouvrante « { » dans va_start(), ainsi les deux macros doivent se trouver dans la même fonction, placées d'une manière qui permette ceci.
BOGUES
Contrairement aux macros varargs(), les macros stdarg() ne permettent pas aux programmeurs de coder une fonction sans aucun argument fixe. Ce problème se pose principalement en convertissant directement du code utilisant varargs() en code utilisant stdarg(), mais il se pose également pour les fonctions qui désirent passer tous leurs arguments à une fonction utilisant un argument va_list comme vfprintf(3).EXEMPLE
La fonction foo() prend une chaîne de caractères de mise en forme, et affiche les arguments associés avec chaque format correspondant au type indiqué.-
#include <stdio.h> #include <stdarg.h> void foo (char *fmt, ...) { va_list ap; int d; char c, *s; va_start(ap, fmt); while (*fmt) switch (*fmt ++) { case 's': /* chaîne */ s = va_arg (ap, char *); printf("chaîne %s\n", s); break; case 'd': /* entier */ d = va_arg (ap, int); printf("int %d\n", d); break; case 'c': /* caractère */ /* need a cast here since va_arg only takes fully promoted types */ c = va_arg (ap, char); printf("char %c\n", c); break; } va_end(ap); }
TRADUCTION
Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 7 novembre 1996 et révisée le 22 novembre 2007.
L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 stdarg ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre