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

CKTIS / C

vprintf — salida con formato desde una va_list

vprintf escribe texto con formato en stdout usando los argumentos de una va_list. Permite crear funciones de salida personalizadas que aceptan un número variable de argumentos.

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

Sintaxis

#include <stdarg.h>
#include <stdio.h>
int vprintf(const char * restrict format, va_list arg);

vprintf funciona como printf, pero acepta una va_list en lugar de argumentos mediante .... Escribe en stdout; vfprintf permite elegir un flujo.

Inicializa la lista con va_start. Después de la llamada, no la reutilices sin volver a inicializarla; llama a va_end. Para recorrerla de forma independiente, usa primero va_copy y después un va_end aparte.

Si quedan argumentos tras procesar todo el formato, se ignoran los argumentos sobrantes. El comportamiento es indefinido si faltan argumentos o si el tipo de algún argumento, tras las promociones de argumentos predeterminadas, no coincide con el que exige su especificación de conversión. Pasa el texto no confiable como dato para %s, no como formato.

El valor de retorno indica el número de caracteres transmitidos, o es negativo si se produce un error de salida o de codificación. El ejemplo espera 10, incluido \n.

Ejemplos

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

static int print_message(const char *format, ...)
{
    va_list args;
    va_start(args, format);
    int result = vprintf(format, args);
    va_end(args);
    return result;
}

int main(void)
{
    int count = print_message("%s: %d\n", "Score", 42);
    if (count != 10) {
        return EXIT_FAILURE;
    }
    if (fflush(stdout) == EOF) {
        return EXIT_FAILURE;
    }
    return EXIT_SUCCESS;
}

Resultado

Score: 42

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