Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

vfprintf — output formattato da va_list

vfprintf scrive dati formattati in uno stream FILE e riceve gli argomenti da una va_list anziché da un elenco di argomenti variabili.

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

Sintassi

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

vfprintf funziona come fprintf, ma accetta una va_list. Gli header necessari sono <stdio.h> e <stdarg.h>; le regole di formattazione restano le stesse.

Inizializza l’elenco con va_start. Dopo la chiamata, non riutilizzarlo, tranne che per va_end. Per una scansione indipendente, crea prima una copia con va_copy e termina anche quella copia con va_end.

Il risultato è il numero di caratteri scritti oppure un valore negativo in caso di errore di output o di codifica. I tipi degli argomenti devono corrispondere al formato; le discrepanze causano comportamento indefinito. Passa il testo non attendibile tramite %s, non come formato.

Esempi

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

static int write_message(FILE *stream, const char *format, ...)
{
    va_list args;
    va_start(args, format);
    int result = vfprintf(stream, format, args);
    va_end(args);
    return result;
}

int main(void)
{
    int count = write_message(stdout, "%s: %d\n", "Items", 3);
    int flush_result = fflush(stdout);
    return count == 9 && flush_result == 0 ? EXIT_SUCCESS : EXIT_FAILURE;
}

Risultato

Items: 3

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