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);  

La fonction appelée doit déclarer un objet de type va_list utilisé par les macros va_start(), va_arg() et va_end().  

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.  

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

va_list aq;
*aq = *ap;

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

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);
}

#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);
}

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 avril 2008.

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.

NOM

SYNOPSIS

DESCRIPTION

va_start()

va_arg()

va_end()

va_copy()

CONFORMITÉ

NOTES

BOGUES

EXEMPLE

TRADUCTION