Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

<stdarg.h> — argumentos variádicos

El encabezado <stdarg.h> proporciona va_list y macros para leer los argumentos sin nombre de funciones con ... y copiar el estado de lectura.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

#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 un va_list; C23 permite va_start(ap) sin el último parámetro con nombre. va_arg(ap, type) obtiene el siguiente argumento. El contrato de llamada, no el encabezado, determina el número de argumentos.

va_copy crea un estado de lectura independiente; la asignación no es un sustituto portable. Cada inicialización requiere va_end en la misma función.

Ten en cuenta las promociones predeterminadas de los argumentos: float se promociona a double, y los tipos sujetos a promoción entera se promocionan a int o unsigned int. En C23, un argumento de tipo signed _BitInt(8) que no es un campo de bits no está sujeto a la promoción entera. Obtenlo con va_arg(ap, signed _BitInt(8)), no con va_arg(ap, int). Usar un tipo incompatible, salvo en los casos previstos por el estándar, o leer más allá del final de la lista de argumentos provoca un comportamiento indefinido.

Ejemplos

#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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes