Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

<stdarg.h> — arguments variadiques

L’en-tête <stdarg.h> fournit va_list et des macros permettant de lire les arguments sans nom des fonctions avec ... et de copier l’état de lecture.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stdarg.h>
va_list ap, copy;
va_start(ap);
value = va_arg(ap, type);
va_copy(copy, ap);
va_end(copy);
va_end(ap);

va_start initialise un va_list ; C23 autorise va_start(ap) sans le dernier paramètre nommé. va_arg(ap, type) récupère l’argument suivant. Le contrat d’appel, et non l’en-tête, détermine le nombre d’arguments.

va_copy crée un état de lecture indépendant ; une affectation n’est pas un substitut portable. Chaque initialisation doit être suivie de va_end dans la même fonction.

Tenez compte des promotions d’arguments par défaut : float est promu en double, et les types soumis aux promotions entières sont promus en int ou unsigned int. En C23, un argument de type signed _BitInt(8) qui n’est pas un champ de bits échappe aux promotions entières. Récupérez-le avec va_arg(ap, signed _BitInt(8)), et non avec va_arg(ap, int). Un type incompatible, sauf dans les cas prévus par la norme, ou une lecture au-delà de la fin de la liste d’arguments entraîne un comportement indéfini.

Exemples

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

static void sum_twice(int count, ...)
{
    va_list ap, copy;
    va_start(ap, count);
    va_copy(copy, ap);
    int first = 0, second = 0;
    for (int i = 0; i < count; ++i) {
        first += va_arg(ap, int);
        second += va_arg(copy, int);
    }
    va_end(copy);
    va_end(ap);
    printf("%d %d\n", first, second);
}

int main(void)
{
    sum_twice(3, 10, 20, 30);
    return 0;
}

Résultat

60 60

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources