vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l

Articolo
03/05/2013

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 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_s e vfwprintf_s 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, o se la stringa di formato contiene caratteri di formattazione non validi, 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.

Queste funzioni differiscono solo nelle versioni non sicure in quanto le versioni sicure che controllano format la stringa contiene caratteri di formattazione validi.

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

Requisiti

routine	Intestazione di associazione	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> *

* 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