Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

va_arg — ler o argumento seguinte

A macro va_arg de <stdarg.h> lê o argumento seguinte na parte ... de uma função e avança o estado de va_list.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

va_arg(ap, type) é uma macro, não uma função. Devolve o argumento seguinte como uma expressão do tipo type e avança ap. Inicialize a lista com va_start ou va_copy, sem que depois tenha sido chamado va_end.

Em geral, type tem de corresponder ao tipo resultante das promoções predefinidas dos argumentos. Leia como double um argumento passado como float. O tipo char é promovido a int se int puder representar todos os valores de char; caso contrário, é promovido a unsigned int. Use o tipo resultante dessa promoção. Se char tiver sido promovido a unsigned int, ler como int um valor superior a INT_MAX causa comportamento indefinido: a exceção para tipos inteiros correspondentes com e sem sinal só se aplica se o valor for representável em ambos os tipos. Exceto nos casos previstos pela norma, um tipo incompatível causa comportamento indefinido; ler para além do fim também. A macro não consegue detetar o fim: use um protocolo acordado, como um contador.

Cada va_start ou va_copy requer um va_end correspondente na mesma função. O exemplo lê três valores double; count indica o respetivo número.

Exemplos

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

Resultado

7.0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes