NOM¶

stdarg, va_start, va_arg, va_end, va_copy - Liste variable d'arguments

BIBLIOTHÈQUE¶

Bibliothèque C standard (libc, -lc)

SYNOPSIS¶

#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_list aq = ap;

va_list aq;
*aq = *ap;

va_list aq;
va_copy(aq, ap);
...
va_end(aq);

ATTRIBUTS¶

Pour une explication des termes utilisés dans cette section, consulter attributes(7).

STANDARDS¶

C11, POSIX.1-2008.

HISTORIQUE¶

va_start()

va_arg()

va_end()

C89, POSIX.1-2001.

va_copy()

C99, POSIX.1-2001.

AVERTISSEMENTS¶

Contrairement aux macros varargs() historiques, 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 telle que vfprintf(3).

EXEMPLES¶

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, ...)   /* '...' est la syntaxe C des fonctions variadiques */
{


    va_list ap;


    int d;


    char c;


    char *s;


    va_start(ap, fmt);


    while (*fmt)


        switch (*fmt++) {


        case 's':              /* chaîne */


            s = va_arg(ap, char *);


            printf("string %s\n", s);


            break;


        case 'd':              /* entier */


            d = va_arg(ap, int);


            printf("int %d\n", d);


            break;


        case 'c':              /* caractère */


            /* il faut une conversion de type ici


               puisque va_arg ne prend que des


               types entièrement promus */


            c = (char) va_arg(ap, int);


            printf("char %c\n", c);


            break;


        }


    va_end(ap);
}

VOIR AUSSI¶

vprintf(3), vscanf(3), vsyslog(3)

TRADUCTION¶

La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org>, Cédric Boutillier <cedric.boutillier@gmail.com>, Frédéric Hantrais <fhantrais@gmail.com> et Grégoire Scano <gregoire.scano@malloc.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.