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

CKTIS / C

va_start — inicializar o acesso a argumentos variáveis

A macro va_start de <stdarg.h> inicializa uma va_list para ler argumentos passados através de reticências. Em C23, basta chamar va_start(ap).

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

Sintaxe

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

va_start é uma macro, não uma função. No interior de uma função variádica, inicializa uma va_list antes de aceder aos argumentos ...; não devolve qualquer valor.

C23 permite va_start(ap). Os argumentos adicionais destinam-se a suportar código mais antigo; só o primeiro é avaliado.

va_arg lê os argumentos sucessivamente. O código tem de conhecer a quantidade e os tipos após as promoções dos argumentos; leituras incorretas podem causar comportamento indefinido.

Cada va_start exige um va_end na mesma função antes de esta regressar, e também antes de voltar a inicializar o mesmo ap. Utilize va_copy para copiar o estado da travessia.

Exemplos

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

Resultado

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