vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l

Articolo
06/09/2015

Scrivere l'output formattato utilizzando un puntatore a un elenco di argomenti. Più versioni sicure di queste funzioni sono presenti; vedere vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l.

int vfprintf(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vfwprintf(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_l(
   FILE *stream,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Parametri

stream
puntatore a FILE struttura.
format
Specifica di formato.
argptr
Puntatore all'elenco degli argomenti.
locale
le impostazioni locali da utilizzare.

Per ulteriori informazioni, vedere Specifiche di formato.

Valore restituito

vfprintf e vfwprintf restituisce il numero di caratteri scritto, escluso il carattere di terminazione null, o un valore negativo se un errore di output si verifica. Se uno stream o format è un puntatore null, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri. Se l'esecuzione è consentita per continuare, le funzioni restituiscono -1 e impostate errno in EINVAL.

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

Note

Ognuna di queste funzioni accetta un puntatore a un elenco di argomenti, quindi i formati e scrive i dati specificati a stream.

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

le versioni di queste funzioni con _l il suffisso è identico con la differenza che utilizzano il parametro delle impostazioni locali passato alle impostazioni locali del thread corrente.

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

Mapping di routine a testo generico

routine di TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_vftprintf	vfprintf	vfprintf	vfwprintf
_vftprintf_l	_vfprintf_l	_vfprintf_l	_vfwprintf_l

Requisiti

routine	Intestazione di associazione	intestazioni facoltative
vfprintf, _vfprintf_l	<stdio.h> e <stdarg.h>	<varargs.h> *
vfwprintf, _vfwprintf_l	<stdio.h> o <wchar.h> e <stdarg.h>	<varargs.h> *

* Obbligatorio per la compatibilità dell'utilità UNIX V.

per informazioni di compatibilità aggiuntive, vedere compatibilità nell'introduzione.

Equivalente .NET Framework

Non applicabile. Per chiamare la funzione c standard, utilizzare PInvoke. Per ulteriori informazioni, vedere Esempi di pinvoke.

Vedere anche

Riferimenti

I/O di flusso

Funzioni vprintf

fprintf, _fprintf_l, fwprintf, _fwprintf_l

printf, _printf_l, wprintf, _wprintf_l

sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l

va_arg, va_copy, va_end, va_start

Condividi tramite