_vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l
Scrive l'output formattato nella console tramite un puntatore a un elenco di argomenti. Sono disponibili versioni più sicure di queste funzioni., vedere _vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l.
Importante
Questa API non può essere utilizzata nelle applicazioni che vengono eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.
int _vcprintf(
const char* format,
va_list argptr
);
int _vcprintf_l(
const char* format,
locale_t locale,
va_list argptr
);
int _vcwprintf(
const wchar_t* format,
va_list argptr
);
int _vcwprintf_l(
const wchar_t* format,
locale_t locale,
va_list argptr
);
Parametri
format
Specifica di formato,argptr
Puntatore all'elenco di argomenti.locale
Impostazioni locali da utilizzare.
Per ulteriori informazioni, vedere Specifiche di formato.
Valore restituito
Il numero di caratteri scritti, o un valore negativo se si verifica un errore di output. Se format è un puntatore a null, viene richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, errno è impostato su EINVAL e viene restituito -1.
Note
Ognuna di queste funzioni accetta un puntatore a un elenco di argomenti, quindi formatta e scrive i relativi dati sulla console. _vcwprintf è la versione a caratteri di tipo "wide" di _vcprintf. Accetta una stringa di caratteri estesi come argomento.
Le versioni di queste funzioni con il suffisso _l sono identiche ad eccezione che utilizzano il parametro delle impostazioni locali passato in ingresso invece di utilizzare le impostazioni locali correnti.
Nota sulla sicurezza |
---|
Assicurarsi che format non sia una stringa definita dall'utente.Per ulteriori informazioni, vedere Evitare sovraccarichi del buffer. |
Mapping di routine su testo generico
Routine TCHAR.H |
_UNICODE & _MBCS non definiti |
_MBCS definito |
_UNICODE definito |
---|---|---|---|
_vtcprintf |
_vcprintf |
_vcprintf |
_vcwprintf |
_vtcprintf_l |
_vcprintf_l |
_vcprintf_l |
_vcwprintf_l |
Requisiti
Routine |
Intestazione obbligatoria |
Intestazioni facoltative |
---|---|---|
_vcprintf, _vcprintf_l |
<conio.h> e <stdarg.h> |
<varargs.h>* |
_vcwprintf, _vcwprintf_l |
<conio.h> o <wchar.h>, e <stdarg.h> |
<varargs.h>* |
* Necessario per la compatibilità con UNIX V.
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità.
Esempio
// crt_vcprintf.cpp
// compile with: /c
#include <conio.h>
#include <stdarg.h>
// An error formatting function used to print to the console.
int eprintf(const char* format, ...)
{
va_list args;
va_start(args, format);
return _vcprintf(format, args);
}
int main()
{
eprintf(" (%d:%d): Error %s%d : %s\n", 10, 23, "C", 2111,
"<some error text>");
eprintf(" (Related to symbol '%s' defined on line %d).\n",
"<symbol>", 5 );
}
Equivalente .NET Framework
Vedere anche
Riferimenti
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l