_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Articolo
03/26/2013

Formatta e stampa nella console.Più versioni 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 formato e di controllo.
argument
Parametri facoltativi.
locale
Le impostazioni locali da utilizzare.

Valore restituito

Il numero di caratteri stampato.

Note

Queste funzioni diformattazione e di stampa una stringa di caratteri e i valori direttamente nella console, utilizzando la funzione di _putch (_putwch per _cwprintf) per restituire i caratteri.Ogni argument (se presenti) viene convertito e restituito alla specifica di formato corrispondente in format.Il formato con lo stesso form e del parametro di format per la funzione di printf.A differenza di fprintf, di printfe le funzioni di sprintf, né né _cprintf_cwprintf converte i caratteri di avanzamento riga in miscugli di un feed di ritorno- riga del carrello (CR-LF) quando output.

Una differenza importante è che _cwprintf visualizzare i caratteri unicode se utilizzato in 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 il parametro di format.Se format è un puntatore null, la funzione viene richiamato il gestore non valido di parametro, come descritto in Convalida dei parametri.Se l'esecuzione può continuare, la funzione restituisce -1 ed imposta errno a EINVAL.

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

Mapping di routine a 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à nell'introduzione.

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