vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l

Articolo
03/05/2013

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

Flusso I/O

funzioni di vprintf

fprintf, _fprintf_l, fwprintf, _fwprintf_l

printf, _printf_l, wprintf, _wprintf_l

sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l

va_arg, va_end, va_start

Condividi tramite