Condividi tramite

_printf_p, _printf_p_l, _wprintf_p_wprintf_p_l

  • Articolo

Stampa l'output formattato nel flusso di output standard e consente di specificare l'ordine in cui i parametri vengono utilizzati nella stringa di formato.

Sintassi

int _printf_p(
   const char *format [,
   argument]...
);
int _printf_p_l(
   const char *format,
   _locale_t locale [,
   argument]...
);
int _wprintf_p(
   const wchar_t *format [,
   argument]...
);
int _wprintf_p_l(
   const wchar_t *format,
   _locale_t locale [,
   argument]...
);

Parametri

format
Controllo del formato.

argument
Argomenti facoltativi.

locale
Impostazioni locali da usare.

Valore restituito

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

Osservazioni:

La funzione _printf_p formatta e stampa una serie di caratteri e di valori nel flusso di output standard, stdout. Se la stringa format è seguita da argomenti, la stringa format deve contenere le specifiche che determinano il formato di output per gli argomenti (vedere Parametri posizionali printf_p).

La differenza tra _printf_p e printf_s è che _printf_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).

_wprintf_p è la versione a caratteri wide di _printf_p. Il comportamento è identico se il flusso viene aperto in modalità ANSI. _printf_p non supporta attualmente l'output in un flusso UNICODE.

Le versioni di queste funzioni con il suffisso _l sono identiche ad eccezione per il fatto che utilizzano il parametro delle impostazioni locali passato al posto di quelle del thread corrente.

Importante

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

Se format o argument sono NULL, o della stringa di formato contiene caratteri _printf_p di formattazione non validi e _wprintf_p le funzioni richiamano un gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce -1 e imposta errno su EINVAL.

Mapping di routine di testo generico

Routine Tchar.h _UNICODE e _MBCS non definito _MBCS definito _UNICODE definito
_tprintf_p _printf_p _printf_p _wprintf_p
_tprintf_p_l _printf_p_l _printf_p_l _wprintf_p_l

Requisiti

Ciclo Intestazione obbligatoria
_printf_p, _printf_p_l <stdio.h>
_wprintf_p, _wprintf_p_l <stdio.h> o <wchar.h>

La console non è supportata nelle app piattaforma UWP (Universal Windows Platform) (UWP). Gli handle di flusso standard associati alla console, stdin, stdoute stderrdevono essere reindirizzati prima che le funzioni di runtime C possano usarle nelle app UWP. Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Importante

A partire da Windows 10 versione 2004 (build 19041), la printf famiglia di funzioni stampa numeri a virgola mobile esattamente rappresentabili in base alle regole IEEE 754 per l'arrotondamento. Nelle versioni precedenti di Windows, i numeri a virgola mobile che terminano in '5' verrebbero sempre arrotondati. IEEE 754 indica che devono essere arrotondati 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.

Esempio

// crt_printf_p.c
// This program uses the _printf_p and _wprintf_p
// functions to choose the order in which parameters
// are used.

#include <stdio.h>

int main( void )
{
   // Positional arguments
   _printf_p( "Specifying the order: %2$s %3$s %1$s %4$s %5$s.\n",
              "little", "I'm", "a", "tea", "pot");

   // Resume arguments
   _wprintf_p( L"Reusing arguments: %1$d %1$d %1$d %1$d\n", 10);

   // Width argument
   _printf_p("Width specifiers: %1$*2$s", "Hello\n", 10);
}

Specifying the order: I'm a little tea pot.
Reusing arguments: 10 10 10 10
Width specifiers:     Hello

Vedi anche

Supporto matematico e a virgola mobile
I/O di flusso
impostazioni locali
fopen, _wfopen
_fprintf_p, _fprintf_p_l, _fwprintf_p_fwprintf_p_l
fprintf, _fprintf_l, fwprintf_fwprintf_l
fprintf_s, _fprintf_s_l, fwprintf_s_fwprintf_s_l
scanf, _scanf_l, wscanf_wscanf_l
scanf_s, _scanf_s_l, wscanf_s_wscanf_s_l
_sprintf_p, _sprintf_p_l, _swprintf_p_swprintf_p_l
sprintf, _sprintf_l, swprintf, _swprintf_l__swprintf_l
sprintf_s, _sprintf_s_l, swprintf_s_swprintf_s_l
Funzioni vprintf