_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

Articolo
03/15/2013

Formatta e stampa la console, con supporto per i parametri posizionali nella stringa di formato.

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_p( 
   const char * format [, 
   argument] ... 
);
int _cprintf_p_l( 
   const char * format,
   locale_t locale [, 
   argument] ... 
);
int _cwprintf_p(
   const wchar * format [, 
   argument] ...
);
int _cwprintf_p_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 o un valore negativo se si verifica un errore.

Note

Queste funzioni consentono di formattare e di stampa una stringa di caratteri e i valori direttamente nella console, utilizzando le funzioni di _putwch e di _putch 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_p.La differenza tra _cprintf_p e cprintf_s è che _cprintf_p supporta i parametri posizionali, che consente di specificare l'ordine in cui gli argomenti vengono utilizzati nella stringa di formato.Per ulteriori informazioni, vedere parametri posizionali di printf_p.

A differenza di fprintf_p, di printf_pe le funzioni di sprintf_p, né né _cprintf_p_cwprintf_p 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_p visualizzare i caratteri unicode se utilizzato in Windows NT.A differenza di _cprintf_p, _cwprintf_p 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.

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

Inoltre, come _cprintf_s e _cwprintf_s, convalidare il puntatore di input e la stringa di formato.Se format o argument è NULL, o di stringa contiene caratteri di formattazione non validi, queste funzioni richiamare il gestore non valido di parametro, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, queste funzioni restituiscono -1 e errno impostato su EINVAL.

Mapping di routine a Testo generico

Routine Tchar.h	_UNICODE e _MBCS non definiti	_MBCS definito	_UNICODE definito
_tcprintf_p	_cprintf_p	_cprintf_p	_cwprintf_p
_tcprintf_p_l	_cprintf_p_l	_cprintf_p_l	_cwprintf_p_l

Requisiti

Routine	Intestazione obbligatoria
_cprintf_p,_cprintf_p_l	<conio.h>
_cwprintf_p,_cwprintf_p_l	<conio.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità.

Esempio

// crt_cprintf_p.c
// This program displays some variables to the console
// using the _cprintf_p function.

#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_p( "%2$d  %1$.4x  %3$u  %4$c %5$s\r\n", 
                h, i, u, c, s );
}