Condividi tramite


_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 sicurezzaNota 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

System::Console::Write

Vedere anche

Riferimenti

I/O di flusso

Funzioni vprintf

_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

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