_cprintf_p, _cprintf_p_l, _cwprintf_p_cwprintf_p_l

Formatta e stampa nella console e supporta parametri posizionali nella stringa di formato.

Sintassi

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 controllo del formato.

argument
Parametri facoltativi.

locale
Impostazioni locali da usare.

Valore restituito

Il numero di caratteri stampati o un valore negativo se si verifica un errore.

Osservazioni:

Queste funzioni formattano e stampano una serie di caratteri e valori direttamente sulla console, utilizzando le funzioni _putch e _putwch 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_p funzione. La differenza tra _cprintf_p e cprintf_s è che _cprintf_p supporta i parametri posizionali, che consentono di specificare l'ordine in cui gli argomenti vengono utilizzati nella stringa di formato. Per altre informazioni, vedere printf_p Positional Parameters (Parametri posizionali printf_p).

A differenza delle fprintf_pfunzioni _cprintf_p , printf_pe sprintf_p e _cwprintf_p non convertono i caratteri del feed di riga in combinazioni di ritorno a capo (CR-LF) durante l'output. Una differenza importante è che _cwprintf_p visualizza i caratteri Unicode se usato 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 per il fatto che usano il parametro delle impostazioni locali passato al posto di quelle correnti.

Inoltre, come _cprintf_s e _cwprintf_s, convalidano il puntatore di input e la stringa di formato. Se format o argument sono NULLo della stringa di formato contiene caratteri di formattazione non validi, queste funzioni richiamano il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni restituiscono -1 e impostano errno su EINVAL.

Mapping di routine di testo generico

Requisiti

Per altre informazioni sulla compatibilità, vedere Compatibility (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 );
}

-16  001d  62511  A Test

Vedi anche

I/O della console e della porta
_cscanf, _cscanf_l, _cwscanf_cwscanf_l
_cscanf_s, _cscanf_s_l, _cwscanf_s_cwscanf_s_l
_fprintf_p, _fprintf_p_l, _fwprintf_p_fwprintf_p_l
fprintf_s, _fprintf_s_l, fwprintf_s_fwprintf_s_l
_printf_p, _printf_p_l, _wprintf_p_wprintf_p_l
printf_s, _printf_s_l, wprintf_s_wprintf_s_l
_sprintf_p, _sprintf_p_l, _swprintf_p_swprintf_p_l
_vfprintf_p, _vfprintf_p_l, _vfwprintf_p_vfwprintf_p_l
_cprintf_s, _cprintf_s_l, _cwprintf_s_cwprintf_s_l
Parametri posizionali printf_p
Sintassi della specifica del formato: printf e wprintf funzioni