Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

vprintf — output formattato da una va_list

vprintf scrive testo formattato su stdout usando gli argomenti di una va_list. Consente di creare funzioni di output personalizzate che accettano un numero variabile di argomenti.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

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

vprintf funziona come printf, ma accetta una va_list invece di argomenti passati tramite .... Scrive su stdout; vfprintf permette di scegliere uno stream.

Inizializza la lista con va_start. Dopo la chiamata, non riutilizzarla senza inizializzarla di nuovo; chiama va_end. Per un’iterazione indipendente, usa prima va_copy e poi un va_end separato.

Se rimangono argomenti dopo aver elaborato l’intero formato, quelli in eccesso vengono ignorati. Il comportamento è indefinito se mancano argomenti o se il tipo di un argomento, dopo le promozioni predefinite degli argomenti, non corrisponde a quello richiesto dalla relativa specifica di conversione. Passa il testo non attendibile come dato per %s, non come formato.

Il valore restituito indica il numero di caratteri trasmessi, oppure è negativo in caso di errore di output o di codifica. L’esempio si aspetta 10, compreso \n.

Esempi

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

Risultato

Score: 42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti