Funzioni vprintfvprintf Functions

Ognuna delle funzioni vprintf accetta un puntatore a un elenco di argomenti e quindi formatta e scrive i dati specificati in una destinazione particolare.Each of the vprintf functions takes a pointer to an argument list, then formats and writes the given data to a particular destination. Le funzioni differiscono per il tipo di convalida dei parametri eseguita, per l'uso di stringhe di caratteri di tipo wide o a byte singolo, per la destinazione di output e per il modo in cui viene specificato l'ordine in cui i parametri vengono usati nella stringa di formato.The functions differ in the parameter validation performed, whether the functions take wide or single-byte character strings, the output destination, and the support for specifying the order in which parameters are used in the format string.

_vcprintf, _vcwprintf_vcprintf, _vcwprintf vfprintf, vfwprintfvfprintf, vfwprintf
_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_lvfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l
vprintf, vwprintfvprintf, vwprintf _vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l_vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l
vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_lvprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l vsprintf, vswprintfvsprintf, vswprintf
_vsprintf_p, _vsprintf_p_l, _vswprintf_p, _vswprintf_p_l_vsprintf_p, _vsprintf_p_l, _vswprintf_p, _vswprintf_p_l vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_lvsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l
_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l _vsnprintf, _vsnwprintf_vsnprintf, _vsnwprintf

NoteRemarks

Le funzioni vprintf sono simili alle loro controparti, come indicato nella tabella seguente.The vprintf functions are similar to their counterpart functions as listed in the following table. Tuttavia, ogni funzione vprintf accetta un puntatore a una lista di argomenti, mentre ognuna delle funzioni corrispondenti accetta un elenco di argomenti.However, each vprintf function accepts a pointer to an argument list, whereas each of the counterpart functions accepts an argument list.

Queste funzioni consentono di formattare i dati per l'output verso le destinazioni, come indicato di seguito.These functions format data for output to destinations as follows.

FunzioneFunction Funzione controparteCounterpart function Destinazione di outputOutput destination Convalida dei parametriParameter Validation Supporto parametro posizionalePositional Parameter Support
_vcprintf _cprintf_cprintf consoleconsole Controllo dei valori null.Check for null. Nono
_vcwprintf _cwprintf_cwprintf consoleconsole Controllo dei valori null.Check for null. Nono
vfprintf fprintffprintf StreamStream Controllo dei valori null.Check for null. Nono
vfprintf_pvfprintf_p fprintf_pfprintf_p StreamStream Controllo dei valori null e del formato valido.Check for null and valid format. yes
vfprintf_s fprintf_sfprintf_s StreamStream Controllo dei valori null e del formato valido.Check for null and valid format. Nono
vfwprintf fwprintffwprintf StreamStream Controllo dei valori null.Check for null. Nono
vfwprintf_pvfwprintf_p fwprintf_pfwprintf_p StreamStream Controllo dei valori null e del formato valido.Check for null and valid format. yes
vfwprintf_s fwprintf_sfwprintf_s StreamStream Controllo dei valori null e del formato valido.Check for null and valid format. Nono
vprintf printfprintf Stdout Controllo dei valori null.Check for null. Nono
vprintf_pvprintf_p printf_pprintf_p Stdout Controllo dei valori null e del formato valido.Check for null and valid format. yes
vprintf_s printf_sprintf_s Stdout Controllo dei valori null e del formato valido.Check for null and valid format. Nono
vwprintf wprintfwprintf Stdout Controllo dei valori null.Check for null. nono
vwprintf_pvwprintf_p wprintf_pwprintf_p Stdout Controllo dei valori null e del formato valido.Check for null and valid format. yes
vwprintf_s wprintf_swprintf_s Stdout Controllo dei valori null e del formato valido.Check for null and valid format. Nono
vsprintfvsprintf sprintfsprintf memoria a cui punta buffermemory pointed to by buffer Controllo dei valori null.Check for null. Nono
vsprintf_pvsprintf_p sprintf_psprintf_p memoria a cui punta buffermemory pointed to by buffer Controllo dei valori null e del formato valido.Check for null and valid format. yes
vsprintf_s sprintf_ssprintf_s memoria a cui punta buffermemory pointed to by buffer Controllo dei valori null e del formato valido.Check for null and valid format. Nono
vswprintf swprintfswprintf memoria a cui punta buffermemory pointed to by buffer Controllo dei valori null.Check for null. Nono
vswprintf_pvswprintf_p swprintf_pswprintf_p memoria a cui punta buffermemory pointed to by buffer Controllo dei valori null e del formato valido.Check for null and valid format. yes
vswprintf_s swprintf_sswprintf_s memoria a cui punta buffermemory pointed to by buffer Controllo dei valori null e del formato valido.Check for null and valid format. Nono
_vscprintf _vscprintf_vscprintf memoria a cui punta buffermemory pointed to by buffer Controllo dei valori null.Check for null. Nono
_vscwprintf _vscwprintf_vscwprintf memoria a cui punta buffermemory pointed to by buffer Controllo dei valori null.Check for null. Nono
_vsnprintf _snprintf_snprintf memoria a cui punta buffermemory pointed to by buffer Controllo dei valori null.Check for null. Nono
_vsnwprintf _snwprintf_snwprintf memoria a cui punta buffermemory pointed to by buffer Controllo dei valori null.Check for null. Nono

L'argomento argptr è di tipo va_list, definito in VARARGS.H e in STDARG.H.The argptr argument has type va_list, which is defined in VARARGS.H and STDARG.H. La variabile argptr deve essere inizializzata da va_start e può essere reinizializzata da chiamate successive di va_arg. argptr quindi punterà all'inizio di un elenco di argomenti che vengono convertiti e trasmessi in output in base alle specifiche corrispondenti nell'argomento format.The argptr variable must be initialized by va_start, and may be reinitialized by subsequent va_arg calls; argptr then points to the beginning of a list of arguments that are converted and transmitted for output according to the corresponding specifications in the format argument. format ha la stessa forma e la stessa funzione dell'argomento format di printf.format has the same form and function as the format argument for printf. Nessuna di queste funzioni chiama va_end.None of these functions invokes va_end. Per una descrizione più completa di ogni funzione vprintf, vedere la descrizione della funzione corrispondente come indicato nella tabella precedente.For a more complete description of each vprintf function, see the description of its counterpart function as listed in the preceding table.

_vsnprintf differisce da vsprintf in quanto non scrive più di count byte in buffer._vsnprintf differs from vsprintf in that it writes no more than count bytes to buffer.

Le versioni di queste funzioni con l'infisso w nel nome sono versioni a caratteri wide delle corrispondenti funzioni senza l'infisso w. In ognuna di queste funzioni a caratteri di tipo wide, buffer e format sono stringhe a caratteri wide.The versions of these functions with the w infix in the name are wide-character versions of the corresponding functions without the w infix; in each of these wide-character functions, buffer and format are wide-character strings. Ogni altra funzione a caratteri wide si comporta in modo identico alla funzione SBCS corrispondente.Otherwise, each wide-character function behaves identically to its SBCS counterpart function.

Le versioni di queste funzioni con suffissi _s e _p sono le versioni più sicure.The versions of these functions with _s and _p suffixes are the more secure versions. Queste versioni convalidano le stringhe di formato e generano un'eccezione se la stringa di formato non è ben formata, ad esempio se vengono usati caratteri di formattazione non validi.These versions validate the format strings and will generate an exception if the format string is not well formed (for example, if invalid formatting characters are used).

Le versioni di queste funzioni con il suffisso _p consentono di specificare l'ordine in cui gli argomenti forniti vengono sostituiti nella stringa di formato.The versions of these functions with the _p suffix provide the ability to specify the order in which the supplied arguments are substituted in the format string. Per altre informazioni, vedere printf_p Positional Parameters (Parametri posizionali printf_p).For more information, see printf_p Positional Parameters.

Per vsprintf, vswprintf, _vsnprintf e _vsnwprintf, se si verifica una copia tra stringhe che si sovrappongono, il comportamento non è definito.For vsprintf, vswprintf, _vsnprintf and _vsnwprintf, if copying occurs between strings that overlap, the behavior is undefined.

Importante

Assicurarsi che format non sia una stringa definita dall'utente.Ensure that format is not a user-defined string. Per altre informazioni, vedere Evitare sovraccarichi del buffer.For more information, see Avoiding Buffer Overruns. Se si usano le versioni sicure di queste funzioni, con il suffisso _s o _p, e la stringa di formato specificata dall'utente contiene caratteri di formattazione non validi, potrebbe verificarsi un'eccezione di parametro non valido.If using the secure versions of these functions (either the _s or _p suffixes), a user-supplied format string could trigger an invalid parameter exception if the user-supplied string contains invalid formatting characters.

Vedere ancheSee Also

I/O di flusso Stream I/O
fprintf, _fprintf_l, fwprintf, _fwprintf_l fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l printf, _printf_l, wprintf, _wprintf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
va_arg, va_copy, va_end, va_startva_arg, va_copy, va_end, va_start