printf, _printf_l, wprintf, _wprintf_l

Articolo
06/09/2015

Stampa l'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.

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 formato.
argument
Argomenti facoltativi.
locale
Impostazioni locali da utilizzare.

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 parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce -1 e imposta errno su EINVAL. Se EOF (0xFFFF) viene visualizzato in argument, la funzione restituisce -1.

Per informazioni su errno e i codici di errore, vedere _doserrno, errno, _sys_errlist e _sys_nerr.

Note

La funzione printf formatta e stampa una serie di caratteri e di valori nel flusso di output standard, stdout. Se gli argomenti seguono la stringa format, la stringa format deve contenere le specifiche che determinano il formato di output per gli argomenti. printf e fprintf si comportano in modo identico con la differenza che printf scrive l'output in stdout anziché una destinazione di tipo FILE.

wprintf è una versione a caratteri di tipo "wide" di printf; in format è una stringa di caratteri di tipo "wide". wprintf e printf si comportano in modo identico 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 in ingresso invece di utilizzare quelle del thread corrente.

Mapping di routine su testo generico

Routine TCHAR.H	_UNICODE e _MBCS non definiti	_MBCS definito	_unicode definito
_tprintf	printf	printf	wprintf

L'argomento format è costituito da caratteri ordinari, sequenze di escape e, se gli argomenti seguono format, dalle specifiche di formato. I caratteri ordinari e le sequenze di escape vengono copiati in stdout per il relativo aspetto. Ad esempio, la riga:

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

produce l'output:

Line one
        Line two

Specifiche di formato inizia sempre con un segno di percentuale (%) e viene letto da sinistra a destra. Quando printf incontra la prima specifica del formato (se esistente), converte il valore del primo argomento dopo format e ne esegue l'output di conseguenza. La seconda specifica di formato causa la conversione e la restituzione del secondo argomento e così via. Se sono presenti più argomenti che sono specifiche di formato, gli argomenti aggiuntivi vengono ignorati. I risultati non sono definiti se non vi sono argomenti sufficienti per tutte le specifiche di formato.

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

Mapping di routine su testo generico

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

Requisiti

Routine	Intestazione obbligatoria
printf, _printf_l	<stdio.h>
wprintf, _wprintf_l	<stdio.h> o <wchar.h>

La console non è supportata nelle applicazioni Windows Store. Gli handle del flusso standard associati alla console,stdin, stdout e stderr, devono essere reindirizzati prima di poter utilizzare le funzioni di runtime del linguaggio C nelle applicazioni Windows Store. Per ulteriori informazioni sulla compatibilità, vedere Compatibilità.

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

Esempio di output

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