printf, _printf_l, wprintf_wprintf_l

Stampa output formattato nel flusso di output standard. Sono disponibili versioni più sicure di queste funzioni; vedere printf_s, _printf_s_l, wprintf_s, _wprintf_s_l.

Sintassi

int printf(
   const char *format [,
   argument]...
);
int _printf_l(
   const char *format,
   _locale_t locale [,
   argument]...
);
int wprintf(
   const wchar_t *format [,
   argument]...
);
int _wprintf_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. Se format è NULL, viene richiamato il 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. Se EOF (0xFFFF) viene rilevato in argument, la funzione restituisce -1.

Per informazioni sui errno codici di errore e , vedere errno, _doserrno, _sys_errliste _sys_nerr.

Osservazioni:

La funzione printf 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. printf e fprintf si comportano in modo identico, ad eccezione del fatto che printf scrive l'output in stdout anziché in una destinazione di tipo FILE.

wprintf è una versione a caratteri wide di printf. format è una stringa di caratteri wide. wprintf e printf si comportano in modo analogo, se il flusso viene aperto in modalità ANSI. printf 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.

L'argomento format è costituito da caratteri ordinari, sequenze di escape, e specifiche di formato (in presenza di argomenti dopo format). I caratteri ordinari e le sequenze di escape vengono copiati in stdout in ordine di visualizzazione. Ad esempio, la riga:

printf("Line one\n\t\tLine two\n");

produce l'output:

Line one
        Line two

Le specifiche di formato iniziano sempre con un segno di percentuale (%) e vengono lette da sinistra a destra. Quando printf rileva la prima specifica di formato (se presente), converte il valore del primo argomento dopo format e lo restituisce. La seconda specifica di formato fa sì che venga convertito e restituito il secondo argomento e così via. Se sono presenti più argomenti che specifiche di formato, gli argomenti aggiuntivi vengono ignorati. I risultati non sono definiti se non sono presenti argomenti sufficienti per tutte le specifiche di formato.

Importante

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

Mapping di routine di testo generico

Tchar.h routine _UNICODE e _MBCS non definito _MBCS definito _UNICODE definito
_tprintf printf printf wprintf
_tprintf_l _printf_l _printf_l _wprintf_l

Requisiti

Ciclo Intestazione obbligatoria
printf, _printf_l <stdio.h>
wprintf, _wprintf_l <stdio.h> oppure <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.c
// This program uses the printf and wprintf functions
// to produce formatted output.

#include <stdio.h>

int main( void )
{
   char     ch = 'h',
            *string = "computer";
   wchar_t  wch = L'w',
            *wstring = L"Unicode";
   int      count = -9234;
   double   fp = 251.7366;

   // Display integers
   printf( "Integer formats:\n"
           "   Decimal: %d  Justified: %.6d  "
           "Unsigned: %u\n",
           count, count, count, count );

   // Display decimals
   printf( "Decimal %d as:\n   Hex: %Xh  "
           "C hex: 0x%x  Octal: %o\n",
            count, count, count, count );

   // Display in different radixes
   printf( "Digits 10 equal:\n   Hex: %i  "
           "Octal: %i  Decimal: %i\n",
            0x10, 010, 10 );

   // Display characters
   printf("Characters in field (1):\n"
          "%10c%5hc%5C%5lc\n",
          ch, ch, wch, wch);
   wprintf(L"Characters in field (2):\n"
           L"%10C%5hc%5c%5lc\n",
           ch, ch, wch, wch);

   // Display strings
   printf("Strings in field (1):\n%25s\n"
          "%25.4hs\n   %S%25.3ls\n",
          string, string, wstring, wstring);
   wprintf(L"Strings in field (2):\n%25S\n"
           L"%25.4hs\n   %s%25.3ls\n",
           string, string, wstring, wstring);

   // Display real numbers
   printf("Real numbers:\n   %f %.2f %e %E\n",
          fp, fp, fp, fp );

   // Display pointer
   printf( "\nAddress as:   %p\n", &count);
}

Output di esempio

Integer formats:
   Decimal: -9234  Justified: -009234  Unsigned: 4294958062
Decimal -9234 as:
   Hex: FFFFDBEEh  C hex: 0xffffdbee  Octal: 37777755756
Digits 10 equal:
   Hex: 16  Octal: 8  Decimal: 10
Characters in field (1):
         h    h    w    w
Characters in field (2):
         h    h    w    w
Strings in field (1):
                 computer
                     comp
   Unicode                      Uni
Strings in field (2):
                 computer
                     comp
   Unicode                      Uni
Real numbers:
   251.736600 251.74 2.517366e+002 2.517366E+002

Address as:   0012FF3C

Vedi anche

Sintassi della specifica del formato: printf e wprintf funzioni
Supporto matematico e a virgola mobile
I/O di flusso
impostazioni locali
fopen, _wfopen
_fprintf_p, _fprintf_p_l, _fwprintf_p_fwprintf_p_l
scanf, _scanf_l, wscanf_wscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l__swprintf_l
Funzioni vprintf
_set_output_format