_cprintf_s
, _cprintf_s_l
, _cwprintf_s
, _cwprintf_s_l
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_s
funzioni _cprintf_s
, printf_s
e 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 esattamente numeri a virgola mobile rappresentabili in base alle regole I edizione Enterprise E 754 per l'arrotondamento. Nelle versioni precedenti di Windows, i numeri a virgola mobile che terminano in '5' verrebbero sempre arrotondati. I edizione Enterprise E 754 indica che devono arrotondare 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_l
queste 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
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere:Invia e visualizza il feedback per