vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l

Articolo
06/09/2015

Scrivere l'output formattato utilizzando un puntatore a un elenco di argomenti. Queste sono versioni di vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l con i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in CRT.

int vfprintf_s(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_s_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vfwprintf_s(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_s_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_s e vfwprintf_s restituiscono il numero di caratteri scritti, escluso il carattere di terminazione null, o un valore negativo se un errore di output viene visualizzato. 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.

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 stream.

Queste funzioni differiscono dalle versioni non sicure solo per il fatto che le versioni sicure controllano che la stringa format contenga caratteri di formattazione validi.

vfwprintf_s è la versione a caratteri estesi di vfprintf_s; se il flusso viene aperto in modalità ANSI, le due funzioni si comportano in modo identico. vfprintf_s 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.

Mapping di routine di testo generico

Routine TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_vftprintf_s	vfprintf_s	vfprintf_s	vfwprintf_s
_vftprintf_s_l	_vfprintf_s_l	_vfprintf_s_l	_vfwprintf_s_l

Requisiti

Routine	Intestazione obbligatoria	Intestazioni facoltative
vfprintf_s, _vfprintf_s_l	<stdio.h> e <stdarg.h>	<varargs.h>*
vfwprintf_s, _vfwprintf_s_l	<stdio.h> o <wchar.h>, e <stdarg.h>	<varargs.h>*

* Necessario per la compatibilità con UNIX V.

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'Introduzione.

Equivalente .NET Framework

Non applicabile. Per chiamare la funzione standard C, utilizzare PInvoke. Per ulteriori informazioni, vedere Esempi di Invocazione della Piattaforma.

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