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

CKTIS / C

va_start — initialiser l’accès aux arguments variables

La macro va_start de <stdarg.h> initialise une va_list pour lire les arguments transmis après des points de suspension. En C23, l’appel va_start(ap) suffit.

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

Syntaxe

#include <stdarg.h>
void va_start(va_list ap, ...);

va_start est une macro, pas une fonction. Dans une fonction à nombre variable d’arguments, elle initialise une va_list avant l’accès aux arguments ... ; elle ne renvoie aucune valeur.

C23 autorise va_start(ap). Les arguments supplémentaires servent à prendre en charge l’ancien code ; seul le premier est évalué.

va_arg lit les arguments successifs. Le code doit connaître leur nombre et leurs types après les promotions des arguments ; une lecture incorrecte peut entraîner un comportement indéfini.

Chaque va_start doit être suivi d’un va_end dans la même fonction avant son retour, et aussi avant de réinitialiser le même ap. Utilisez va_copy pour copier l’état du parcours.

Exemples

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

static int sum(unsigned count, ...)
{
    va_list ap;
    va_start(ap, count);
    int total = 0;
    for (unsigned i = 0; i < count; ++i) total += va_arg(ap, int);
    va_end(ap);
    return total;
}

int main(void)
{
    printf("%d\n", sum(3, 10, 20, 30));
    return 0;
}

Résultat

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