_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l

Articolo
06/09/2015

Scrivere l'output formattato utilizzando un puntatore a un elenco di argomenti, con la possibilità di specificare l'ordine in cui gli argomenti sono utilizzati nella stringa di formato.

int _vfprintf_p(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_p_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vfwprintf_p(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_p_l(
   FILE *stream,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Parametri

stream
Puntatore alla struttura FILE.
format
Specifica di formato,
argptr
Puntatore all'elenco di argomenti.
locale
Impostazioni locali da utilizzare.

Per ulteriori informazioni, vedere Specifiche di formato.

Valore restituito

_vfprintf_p e _vfwprintf_p restituiscono il numero di caratteri scritti, escluso il carattere di terminazione null, o un valore negativo se un errore di output viene visualizzato.

Note

Ognuna di queste funzioni accetta un puntatore a un elenco di argomenti, quindi formatta e scrive i relativi dati su stream. Queste funzioni differiscono dalle versioni di _vfprint_s e di _vfwprint_s solo nel fatto che supportano i parametri posizionali. Per ulteriori informazioni, vedere Parametri posizionali printf_p.

_vfwprintf_p è la versione a caratteri estesi di _vprintf_p; se il flusso viene aperto in modalità ANSI, le due funzioni si comportano in modo identico. _vprintf_p non supporta attualmente l'output in un flusso UNICODE.

Le versioni di queste funzioni con il suffisso _l sono identiche ad eccezione per il fatto che utilizzano il parametro delle impostazioni locali passato al posto di quelle del thread corrente.

Nota sulla sicurezza
Assicurarsi che format non sia una stringa definita dall'utente.Per ulteriori informazioni, vedere Evitare sovraccarichi del buffer.

Se stream o format è un puntatore null, o se la stringa di formato contiene caratteri di formattazione non validi, viene invocato il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce -1 e imposta errno a EINVAL.

Mapping di routine di testo generico