Sintassi della specifica del formato: printf e wprintf funzioni

Le diverse funzioni printf e wprintf accettano una stringa di formato e argomenti facoltativi e producono una sequenza di caratteri formattati per l'output. La stringa di formato contiene zero o più direttive, che sono caratteri letterali per l'output o specifiche di conversione codificate che descrivono come formattare un argomento nell'output. Questo articolo descrive la sintassi usata per codificare le specifiche di conversione nella stringa di formato. Per l'elenco di queste funzioni, vedere I/O di flusso.

Una specifica di conversione è costituita da campi obbligatori e facoltativi nel seguente formato:

%[flag][larghezza][.precisione][dimensione]tipo

Ogni campo della specifica di conversione è un carattere o un numero che indica un particolare identificatore di conversione o opzione di formato. Il campo obbligatorio tipo specifica il tipo di conversione da applicare a un argomento. I flag facoltativi, la larghezza e i campi di precisione controllano altri aspetti del formato, ad esempio spazi iniziali o zeri, giustificazione e precisione visualizzata. Il campo dimensione specifica la dimensione dell'argomento usato e convertito.

Una specifica di conversione semplice contiene solo il segno di percentuale e un carattere tipo. Ad esempio, %s specifica una conversione di stringhe. Per stampare un carattere di segno di percentuale, usare %%. Se un segno di percentuale è seguito da un carattere che non ha alcun significato come campo di formato, viene chiamato il gestore di parametro non valido. Per altre informazioni, vedere Convalida dei parametri.

Identificatore di conversione tipo

Il carattere identificatore di conversione tipo specifica se l'argomento corrispondente deve essere interpretato come un carattere, una stringa, un puntatore, un numero intero o un numero a virgola mobile. Il carattere tipo è l'unico campo di specifica conversione obbligatorio e viene visualizzato dopo tutti i campi facoltativi.

Gli argomenti che seguono la stringa di formato vengono interpretati a seconda del carattere tipo corrispondente e del prefisso dimensione facoltativo. Le conversioni per i tipi di char caratteri e wchar_t vengono specificate usando c o Ce le stringhe di caratteri a byte singolo e multibyte o wide vengono specificate tramite s o S, a seconda della funzione di formattazione in uso. Gli argomenti carattere e stringa specificati tramite e c s vengono interpretati come char e char* dalle printf funzioni della famiglia o come wchar_t e wchar_t* in wprintf base alle funzioni della famiglia. Gli argomenti carattere e stringa specificati tramite e C S vengono interpretati come wchar_t e wchar_t* dalle printf funzioni della famiglia o come char e char* in wprintf base alle funzioni della famiglia. Questo comportamento è specifico di Microsoft. Per motivi cronologici, le wprintf funzioni usano c e s per fare riferimento ai wchar_t caratteri e S C specificano caratteri stretti.

I tipi integer, ad shortesempio , intlong, long long, e le relative unsigned varianti, vengono specificati usando d, oxiue .X I tipi a virgola mobile, ad esempio , e , vengono specificati usando a, efgFAEe .Glong doubledoublefloat Per impostazione predefinita, a meno che non vengano modificati da un prefisso di dimensione , gli argomenti integer vengono coerciti per int il tipo e gli argomenti a virgola mobile vengono coerciti su double. Nei sistemi a 64 bit, un int è un valore a 32 bit. Pertanto, i numeri interi a 64 bit verranno troncati quando vengono formattati per l'output, a meno che non venga usato un prefisso di dimensione di ll o I64 . I tipi di puntatore specificati da p usano le dimensioni del puntatore predefinite per la piattaforma.

Caratteri del campo tipo

In Visual Studio 2015 e versioni successive, se l'argomento che corrisponde a un identificatore di conversione a virgola mobile (a, A, feFE, gG) è infinito, indefinito o NaN, l'output formattato è conforme allo standard C99. Questa tabella elenca l'output formattato:

Una di queste stringhe può essere preceduta da un segno. Se un carattere identificatore di conversione tipo a virgola mobile è una lettera maiuscola, anche l'output viene formattato in lettere maiuscole. Ad esempio, se l'identificatore di formato è %F anziché %f, un infinity viene formattato come INF anziché come inf. Anche le funzioni scanf possono analizzare queste stringhe, pertanto questi valori possono completare un round trip tra le funzioni printf e scanf.

Prima di Visual Studio 2015, la libreria CRT usava un formato diverso, non standard per l'output di valori infinite, indefinite e NaN:

Una di queste stringhe può essere stata preceduta da un segno e potrebbe essere stata formattata in modo diverso a seconda della larghezza e della precisione del campo, talvolta con effetti insoliti. Ad esempio, printf("%.2f\n", INFINITY) stampa 1.#J perché il #INF verrebbe "arrotondato" a due cifre di precisione.

Direttive flag

Il primo campo facoltativo in una specifica di conversione contiene direttive flag. Questo campo contiene zero o più caratteri flag che specificano la giustificazione dell'output e controllano l'output di segni, spazi vuoti, zeri iniziali, punti decimali e prefissi ottali ed esadecimali. In una specifica di conversione possono apparire più direttive flag e i caratteri flag possono essere visualizzati in qualsiasi ordine.

Caratteri flag

Specifica della larghezza

In una specifica di conversione, il campo facoltativo di specifica della larghezza viene visualizzato dopo qualsiasi carattere flag. L'argomento width è un numero intero decimale non negativo che controlla il numero minimo di caratteri restituiti. Se il numero di caratteri nel valore di output è inferiore alla larghezza specificata, vengono aggiunti spazi a sinistra o a destra dei valori, a seconda che sia specificato o meno il flag di allineamento a sinistra (-), fino a raggiungere la larghezza minima. Se width è preceduto da 0, gli zeri iniziali vengono aggiunti a conversioni intere o a virgola mobile finché non viene raggiunta la larghezza minima, tranne quando la conversione è in un infinito o NaN.

La specifica della larghezza non provoca mai il troncamento di un valore. Se il numero di caratteri nel valore di output è maggiore della larghezza specificata o se width non viene specificato, vengono restituiti tutti i caratteri del valore, soggetti alla specifica di precisione.

Se la specifica della larghezza è un asterisco (*), il valore è fornito da un argomento int dall'elenco degli argomenti. L'argomento width deve precedere il valore formattato nell'elenco di argomenti, come illustrato in questo esempio:

printf("%0*d", 5, 3); /* 00003 is output */

Un valore mancante o piccolo width in una specifica di conversione non causa il troncamento di un valore di output. Se il risultato di una conversione è più ampio del width valore, il campo si espande per contenere il risultato della conversione.

Specifica della precisione

In una specifica di conversione, il terzo campo facoltativo è la specifica di precisione. È costituito da un punto (.) seguito da un numero intero decimale non negativo che, a seconda del tipo di conversione, specifica il numero di caratteri stringa, il numero di posizioni decimali o il numero di cifre significative da restituire.

A differenza della specifica della larghezza, la specifica della precisione può causare il troncamento del valore di output o l'arrotondamento di un valore a virgola mobile. Se precision viene specificato come 0 e il valore da convertire è 0, il risultato non restituisce alcun output di caratteri, come illustrato in questo esempio:

printf( "%.0d", 0 ); /* No characters output */

Se la specifica della precisione è un asterisco (*), il valore viene specificato da un argomento int dell'elenco degli argomenti. Nell'elenco degli argomenti, l'argomento precision deve precedere il valore da formattare, come illustrato nel seguente esempio:

printf( "%.*f", 3, 3.14159265 ); /* 3.142 output */

Il type carattere determina l'interpretazione di precision o la precisione predefinita quando precision viene omesso, come illustrato nella tabella seguente.

Impatto dei valori di precisione sul tipo

Specifica delle dimensioni dell'argomento

In una specifica di conversione il campo dimensione è un modificatore della lunghezza argomento per l'identificatore di conversione tipo. Il campo size prefisssi al campo tipo,hh , h, j, l (L minuscolo), L, tllw, z( I maiuscolo i), I32e , specificare I64le "dimensioni" dell'argomento corrispondente, long o short, a 32 bit o a 64 bit, carattere a byte singolo o carattere wide, a seconda dell'identificatore di conversione modificato. Questi prefissi di dimensioni vengono usati con i caratteri tipo nei gruppi di funzioni printf e wprintf per specificare l'interpretazione delle lunghezze degli argomenti, come mostrato nella tabella seguente. Il campo dimensione è facoltativo per alcuni tipi di argomento. Quando non viene specificato alcun prefisso, il formattatore usa argomenti di tipo Integer, ad esempio char, short, int, long firmati o non firmati, e tipi di enumerazione, ad esempio i tipi int a 32 bit e gli argomenti a virgola mobile float, double, e long double vengono usati come tipi double a 64 bit. Questo comportamento corrisponde alle regole di promozione degli argomenti predefinite per gli elenchi di argomenti variabili. Per altre informazioni sull'innalzamento di livello degli argomenti, vedere Puntini di sospensione e argomenti predefiniti nelle espressioni di postfissi. Nei sistemi a 32 bit e a 64 bit, la specifica di conversione di un argomento integer a 64 bit deve includere un prefisso di dimensione pari ll a o I64. In caso contrario, il comportamento del formattatore non sarà definito.

Alcuni tipi corrispondono a dimensioni diverse le codice a 32 bit e a 64 bit. Ad esempio, size_t ha una lunghezza pari a 32 bit nel codice compilato per x86 e a 64 bit nel codice compilato per x64. Per creare codice di formattazione indipendente dalla piattaforma per tipi a larghezza variabile, è possibile usare un modificatore di dimensioni per argomenti a larghezza variabile. Usare invece un modificatore di dimensioni degli argomenti a 64 bit e alzare in modo esplicito il tipo di argomento a larghezza variabile a 64 bit. Il modificatore di dimensioni dell'argomento specifico I di Microsoft (i maiuscolo) gestisce gli argomenti integer a larghezza variabile, ma è consigliabile modificare i modificatori specifici del tipo j, te z per la portabilità.

Prefissi di dimensioni per gli identificatori di formato printf e wprintf

I tipi ptrdiff_t e size_t sono __int32 o unsigned __int32 nelle piattaforme a 32 bit e __int64 o unsigned __int64 nelle piattaforme a 64 bit. I I prefissi (i maiuscoli), j, te z accettano la larghezza dell'argomento corretta per la piattaforma.

In Visual C++, anche se long double è un tipo distinto, ha la stessa rappresentazione interna di double.

Un hc identificatore di tipo o hC è sinonimo di c funzioni printf e con C in wprintf funzioni. Un lcidentificatore di tipo , lCwc, o wC è sinonimo di C nelle printf funzioni e con c nelle wprintf funzioni. Un hs identificatore di tipo o hS è sinonimo di s funzioni printf e con S in wprintf funzioni. Un lsidentificatore di tipo , lSws, o wS è sinonimo di S nelle printf funzioni e con s in wprintf funzioni.

Vedi anche

printf, _printf_l, wprintf_wprintf_l
printf_s, _printf_s_l, wprintf_s_wprintf_s_l
printf_p Parametri posizionali