_vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l

Articolo
06/09/2015

Scrive l'output formattato nella console tramite un puntatore a un elenco di argomenti. Queste versioni di _vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l contengono i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in CRT.

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(
   const char* format,
   locale_t locale,
   va_list argptr
);
int _vcwprintf_s(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_s_l(
   const wchar_t* format,
   locale_t locale,
   va_list argptr
);

Parametri

format
Specifica di formato,
argptr
Puntatore ad una lista di argomenti.
locale
Impostazioni locali da utilizzare.

Per ulteriori informazioni, vedere Sintassi per la specifica del formato: funzioni printf wprintf.

Valore restituito

Il numero di caratteri scritti, o un valore negativo se si verifica un errore di output.

Come le versioni meno sicure di queste funzioni, se format è un puntatore null, viene richiamato il gestore di parametri non valido, come descritto in Convalida dei parametri. Inoltre, a differenza delle versioni meno sicure di queste funzioni, se format non specifica un formato valido, viene generata un'eccezione di parametro non valido. Se l'esecuzione può continuare, queste funzioni restituiscono un codice di errore e un set errno al codice di errore. Il codice di errore predefinito è EINVAL se un valore più specifico non viene applicato.

Note

Ognuna di queste funzioni accetta un puntatore a un elenco di argomenti, e quindi formatta e scrive i relativi dati sulla console. _vcwprintf_s è la versione a caratteri di tipo "wide" di _vcprintf_s. Accetta una stringa di caratteri estesi come argomento.

Le versioni di queste funzioni che hanno 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 su testo generico

Routine TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_vtcprintf_s	_vcprintf_s	_vcprintf_s	_vcwprintf_s
_vtcprintf_s_l	_vcprintf_s_l	_vcprintf_s_l	_vcwprintf_s_l

Requisiti

Routine	Intestazione obbligatoria	Intestazioni facoltative
_vcprintf_s, _vcprintf_s_l	<conio.h> e <stdarg.h>	<varargs.h>*
_vcwprintf_s, _vcwprintf_s_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_s.cpp
#include <conio.h>
#include <stdarg.h>

// An error formatting function used to print to the console.
int eprintf_s(const char* format, ...)
{
  va_list args;
  va_start(args, format);
  return _vcprintf_s(format, args);
}

int main()
{
   eprintf_s("  (%d:%d): Error %s%d : %s\n", 10, 23, "C", 2111,
           "<some error text>");
   eprintf_s("  (Related to symbol '%s' defined on line %d).\n",
           "<symbol>", 5 );
}