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

CKTIS / C

<stdarg.h> — argumentos variádicos

O cabeçalho <stdarg.h> disponibiliza va_list e macros para ler os argumentos sem nome das funções com ... e copiar o estado de leitura.

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

Sintaxe

#include <stdarg.h>
va_list ap, copy;
va_start(ap);
value = va_arg(ap, type);
va_copy(copy, ap);
va_end(copy);
va_end(ap);

va_start inicializa um va_list; C23 permite va_start(ap) sem o último parâmetro com nome. va_arg(ap, type) obtém o argumento seguinte. O contrato da chamada, e não o cabeçalho, determina o número de argumentos.

va_copy cria um estado de leitura independente; a atribuição não é um substituto portável. Cada inicialização requer va_end na mesma função.

Tenha em conta as promoções predefinidas dos argumentos: float é promovido a double e os tipos sujeitos a promoção inteira são promovidos a int ou unsigned int. Em C23, um argumento do tipo signed _BitInt(8) que não seja um campo de bits não está sujeito a promoção inteira. Obtenha-o com va_arg(ap, signed _BitInt(8)), não com va_arg(ap, int). Utilizar um tipo incompatível, salvo nos casos previstos pela norma, ou ler para além do fim da lista de argumentos causa comportamento indefinido.

Exemplos

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

static void sum_twice(int count, ...)
{
    va_list ap, copy;
    va_start(ap, count);
    va_copy(copy, ap);
    int first = 0, second = 0;
    for (int i = 0; i < count; ++i) {
        first += va_arg(ap, int);
        second += va_arg(copy, int);
    }
    va_end(copy);
    va_end(ap);
    printf("%d %d\n", first, second);
}

int main(void)
{
    sum_twice(3, 10, 20, 30);
    return 0;
}

Resultado

60 60

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