_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Articolo
06/09/2015

Formatta e stampa nella console. Le versioni più sicure sono disponibili; vedere _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_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 _cprintf( 
   const char * format [, 
   argument] ... 
);
int _cprintf_l( 
   const char * format,
   locale_t locale [,
   argument] … 
);
int _cwprintf(
   const wchar * format [, 
   argument] …
);
int _cwprintf_l(
   const wchar * format,
   locale_t locale [, 
   argument] …
);

Parametri

format
Stringa di controllo del formato.
argument
Parametri facoltativi.
locale
Impostazioni locali da utilizzare.

Valore restituito

Il numero di caratteri da stampare.

Note

Queste funzioni formattano e stampano una stringa di caratteri e i valori direttamente nella console, utilizzando la funzione _putch (_putwch per _cwprintf) per i caratteri di output. Ogni funzione argument (se presente) viene convertita e restituita in base al formato specificato in format. Il formato con lo stesso form e funzione del parametro format per la funzione printf. A differenza fprintf, printf e delle funzioni sprintf, né _cprintf e né _cwprintf convertono nell'output combinazioni di caratteri di avanzamento in caratteri di ritorno a capo (CR-LE).

Una differenza importante è che _cwprintf visualizzare i caratteri Unicode quando si utilizza Windows NT. A differenza di _cprintf, _cwprintf utilizza le impostazioni locali correnti della console.

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.

_cprintf convalida i parametro format. Se format è un puntatore a null, la funzione richiama il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce -1 e imposta errno su EINVAL.

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

Mapping di routine su testo generico

Routine Tchar.h	_UNICODE e _MBCS non definiti	_MBCS definito	_UNICODE definito
_tcprintf	_cprintf	_cprintf	_cwprintf
_tcprintf_l	_cprintf_l	_cprintf_l	_cwprintf_l

Requisiti

Routine	Intestazione obbligatoria
_cprintf,_cprintf_l	<conio.h>
_cwprintf, _cwprintf_l	<conio.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità.

Esempio

// crt_cprintf.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( "%d  %.4x  %u  %c %s\r\n", i, h, u, c, s );
}