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.