Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

va_start — inizializzare l’accesso agli argomenti variabili

La macro va_start di <stdarg.h> inizializza una va_list per leggere gli argomenti passati tramite i puntini di sospensione. In C23 è sufficiente chiamare va_start(ap).

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

Sintassi

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

va_start è una macro, non una funzione. All’interno di una funzione variadica, inizializza una va_list prima di accedere agli argomenti ...; non restituisce alcun valore.

C23 consente va_start(ap). Gli argomenti aggiuntivi servono a supportare il codice precedente; viene valutato solo il primo.

va_arg legge gli argomenti in successione. Il codice deve conoscerne il numero e i tipi dopo le promozioni degli argomenti; letture errate possono causare un comportamento indefinito.

Ogni va_start richiede un va_end nella stessa funzione prima che questa termini, e anche prima di inizializzare di nuovo lo stesso ap. Usa va_copy per copiare lo stato di avanzamento.

Esempi

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

Risultato

60

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti