vprintf, _vprintf_l, vwprintf, _vwprintf_l

Articolo
06/09/2015

Scrive l'output formattato utilizzando un puntatore a un elenco di argomenti. Sono disponibili versioni più sicure di queste funzioni., vedere vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l.

int vprintf(
   const char *format,
   va_list argptr 
);
int _vprintf_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vwprintf(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Parametri

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

Per ulteriori informazioni, vedere Specifiche di formato.

Valore restituito

vprintf e vwprintf restituiscono il numero di caratteri scritti, escluso il carattere di terminazione null, o un valore negativo se un errore di output viene visualizzato. Se format è un puntatore null, o se la stringa di formato contiene caratteri di formattazione non validi, viene richiamato 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.

Per ulteriori informazioni su questi, e altri, codici di errore vedere _doserrno, errno, _sys_errlist, and _sys_nerr .

Note

Ognuna di queste funzioni accetta un puntatore a un elenco di argomenti, quindi formatta e scrive i relativi dati su stdout.

vwprintf è la versione a caratteri estesi di vprintf; se il flusso viene aperto in modalità ANSI, le due funzioni si comportano in modo identico. vprintf 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 in ingresso invece di utilizzare 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.Si noti che stringhe di formato non valido vengono rilevate e danno come risultato un errore.

Mapping di routine su testo generico

Routine TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_vtprintf	vprintf	vprintf	vwprintf
_vtprintf_l	_vprintf_l	_vprintf_l	_vwprintf_l

Requisiti

Routine	Intestazione obbligatoria	Intestazioni facoltative
vprintf, _vprintf_l	<stdio.h> e <stdarg.h>	<varargs.h>*
vwprintf, _vwprintf_l	<stdio.h> o <wchar.h>, e <stdarg.h>	<varargs.h>*

* Necessario per la compatibilità con UNIX V.

La console non è supportata nelle applicazioni Windows Store. Gli handle del flusso standard associati alla console,stdin, stdout e stderr, devono essere reindirizzati prima di poter utilizzare le funzioni di runtime del linguaggio C nelle applicazioni Windows Store. Per ulteriori informazioni sulla compatibilità, vedere Compatibilità.