Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

va_arg — leggere l’argomento successivo

La macro va_arg di <stdarg.h> legge l’argomento successivo nella parte ... di una funzione e fa avanzare lo stato di va_list.

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

Sintassi

#include <stdarg.h>
va_arg(ap, type)

va_arg(ap, type) è una macro, non una funzione. Restituisce l’argomento successivo come espressione di tipo type e fa avanzare ap. Inizializza la lista con va_start o va_copy, senza che in seguito sia stato chiamato va_end.

In generale, type deve corrispondere al tipo risultante dalle promozioni predefinite degli argomenti. Leggi come double un argomento passato come float. Il tipo char viene promosso a int se int può rappresentare tutti i valori di char, altrimenti a unsigned int. Usa il tipo risultante dalla promozione. Se char è stato promosso a unsigned int, leggere come int un valore maggiore di INT_MAX causa un comportamento indefinito: l’eccezione per i tipi interi corrispondenti con e senza segno si applica solo se il valore è rappresentabile in entrambi i tipi. A parte le eccezioni previste dallo standard, l’incompatibilità dei tipi causa un comportamento indefinito; lo stesso vale per la lettura oltre la fine. La macro non può rilevare la fine: usa un protocollo concordato, ad esempio un contatore.

Ogni va_start o va_copy richiede un va_end corrispondente nella stessa funzione. L’esempio legge tre valori double; count ne specifica il numero.

Esempi

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

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

int main(void)
{
    printf("%.1f\n", sum(3, 1.5, 2.0, 3.5));
    return 0;
}

Risultato

7.0

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