_cprintf_s, _cprintf_s_l, _cwprintf_s_cwprintf_s_l

  • Articolo

Formatta e stampa nella console. Queste versioni di _cprintf, _cprintf_l_cwprintf, , _cwprintf_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 _cprintf_s(
   const char * format [,
   argument] ...
);
int _cprintf_s_l(
   const char * format,
   _locale_t locale [,
   argument] ...
);
int _cwprintf_s(
   const wchar * format [,
   argument] ...
);
int _cwprintf_s_l(
   const wchar * format,
   _locale_t locale [,
   argument] ...
);

Parametri

format
Stringa di controllo del formato.

argument
Parametri facoltativi.

locale
Impostazioni locali da usare.

Valore restituito

Numero di caratteri stampati.

Osservazioni:

Queste funzioni formattano e stampano una serie di caratteri e valori direttamente sulla console, usando la funzione _putch (_putwch per _cwprintf_s) per i caratteri di output. Ogni funzione argument (se presente) viene convertita e restituita in base al formato specificato in format. Il formato ha la stessa forma e funzione del format parametro per la printf_s funzione. A differenza delle fprintf_sfunzioni _cprintf_s , printf_se sprintf_s e _cwprintf_s non convertono i caratteri del feed di riga in combinazioni di ritorno a capo (CR-LF) durante l'output.

Una differenza importante è che _cwprintf_s visualizza i caratteri Unicode se usato in Windows NT. A differenza di _cprintf_s, _cwprintf_s usa le impostazioni locali correnti della console

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

Importante

Assicurarsi che format non sia una stringa definita dall'utente.

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".

Analogamente alle versioni non sicure (vedere _cprintf, _cprintf_l_cwprintf, , ), _cwprintf_lqueste funzioni convalidano i relativi parametri e richiamano il gestore di parametri non validi, come descritto in Convalida dei parametri, se format è un puntatore Null. Queste funzioni differiscono dalle versioni non sicure nel fatto che anche la stringa di formato viene convalidata. Se sono presenti identificatori di formattazione sconosciuti o non corretti, queste funzioni richiamano il gestore di parametri non validi. In tutti casi, se l'esecuzione può continuare, le funzioni restituiscono -1 e impostano errno su EINVAL.

Mapping di routine di testo generico

Routine Tchar.h _UNICODE e _MBCS non definito _MBCS definito _UNICODE definito
_tcprintf_s _cprintf_s _cprintf_s _cwprintf_s
_tcprintf_s_l _cprintf_s_l _cprintf_s_l _cwprintf_s_l

Requisiti

Ciclo Intestazione obbligatoria
_cprintf_s, _cprintf_s_l <conio.h>
_cwprintf_s, _cwprintf_s_l <conio.h>

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

Librerie

Tutte le versioni delle librerie di runtime C.

Esempio

// crt_cprintf_s.c
// compile with: /c
// This program displays some variables to the console.

#include <conio.h>

int main( void )
{
   int      i = -16, h = 29;
   unsigned u = 62511;
   char     c = 'A';
   char     s[] = "Test";

   /* Note that console output does not translate \n as
    * standard output does. Use \r\n instead.
    */
   _cprintf_s( "%d  %.4x  %u  %c %s\r\n", i, h, u, c, s );
}

-16  001d  62511  A Test

Vedi anche

I/O della console e della porta
_cscanf, _cscanf_l, _cwscanf_cwscanf_l
fprintf_s, _fprintf_s_l, fwprintf_s_fwprintf_s_l
printf_s, _printf_s_l, wprintf_s_wprintf_s_l
sprintf_s, _sprintf_s_l, swprintf_s_swprintf_s_l
vfprintf_s, _vfprintf_s_l, vfwprintf_s_vfwprintf_s_l
Sintassi della specifica del formato: printf e wprintf funzioni