_vcprintf_s, _vcprintf_s_l, _vcwprintf_s_vcwprintf_s_l

  • Articolo

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

Importante

Non è possibile usare questa API nelle applicazioni eseguite in Windows Runtime. Per altre informazioni, vedere Funzioni CRT non supportate nelle app della piattaforma UWP (Universal Windows Platform).

Sintassi

int _vcprintf_s(
   char const* const format,
   va_list argptr
);
int _vcprintf_s_l(
   char const* const format,
   _locale_t locale,
   va_list argptr
);
int _vcwprintf_s(
   wchar_t const* const format,
   va_list argptr
);
int _vcwprintf_s_l(
   wchar_t const* const format,
   _locale_t locale,
   va_list argptr
);

Parametri

format
Specifica di formato.

argptr
Puntatore all'elenco di argomenti.

locale
Impostazioni locali da usare.

Per altre informazioni, vedere Sintassi delle specifiche di formato: printf e wprintf funzioni.

Valore restituito

Numero di caratteri scritti o un valore negativo se si verifica un errore di output.

Analogamente alle versioni meno sicure di queste funzioni, se format è un puntatore Null, viene richiamato il gestore di parametri non validi, 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 valida. Se l'esecuzione può continuare, queste funzioni restituiscono un codice di errore e impostano errno su tale codice di errore. Il codice di errore predefinito è EINVAL se non si applica un valore più specifico.

Osservazioni:

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

Le versioni di queste funzioni con il suffisso _l sono identiche, ad eccezione del fatto che usano il parametro delle impostazioni locali passato al posto delle impostazioni locali correnti.

Importante

Assicurarsi che format non sia una stringa definita dall'utente. Per altre informazioni, vedere Evitare sovraccarichi del buffer.

Mapping di routine di testo generico

Routine TCHAR.H _UNICODE e _MBCS non definito _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

Ciclo 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>*

* Obbligatorio per la compatibilità di UNIX V.

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Importante

A partire da Windows 10 versione 2004 (build 19041), la printf famiglia di funzioni stampa numeri a virgola mobile esattamente rappresentabili in base alle regole IEEE 754 per l'arrotondamento. Nelle versioni precedenti di Windows, i numeri a virgola mobile che terminano in '5' verrebbero sempre arrotondati. IEEE 754 indica che devono essere arrotondati alla cifra pari più vicina (nota anche come "Arrotondamento del banchiere"). Ad esempio, sia printf("%1.0f", 1.5) che printf("%1.0f", 2.5) devono essere arrotondati a 2. In precedenza, 1,5 arrotonderebbe a 2 e 2,5 arrotonderebbe a 3. Questa modifica influisce solo sui numeri rappresentabili esattamente. Ad esempio, 2.35 (che, se rappresentato in memoria, è più vicino a 2,350000000000000008) continua a arrotondare fino a 2,4. L'arrotondamento eseguito da queste funzioni ora rispetta anche la modalità di arrotondamento a virgola mobile impostata da fesetround. In precedenza, l'arrotondamento ha sempre scelto FE_TONEAREST il comportamento. Questa modifica interessa solo i programmi compilati con Visual Studio 2019 versione 16.2 e successive. Per usare il comportamento di arrotondamento a virgola mobile legacy, collegarsi a legacy_stdio_float_rounding.obj.

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);
    int result = _vcprintf_s(format, args);
    va_end(args);
    return result;
}

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 );
}

(10,23): Error C2111 : <some error text>
    (Related to symbol '<symbol>' defined on line 5).

Vedi anche

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_endva_start