Formatta un valore in virgola mobile.

Struttura

FormatFloat(const Format: string; Value: Extended): string;

Parametri

Valore restituito

Descrizione

FormatFloat formatta il valore in virgola mobile specificato da Value utilizzando la stringa di formato specificata da Format. Nella stringa di formattazione sono supportati i seguenti specificatori di formato:

Il codice specifica un segnaposto di 0 cifre per "

". Se il valore da formattare contiene una cifra nella posizione in cui compare lo «0» nella stringa di formattazione, tale cifra viene copiata nella stringa di output. In caso contrario, in quella posizione della stringa di output viene memorizzato uno "0".

Segno di posizione delle cifre. Se il valore da formattare contiene una cifra nella posizione in cui compare il carattere «#» nella stringa di formattazione, tale cifra viene copiata nella stringa di output. Altrimenti, in quella posizione della stringa di output non viene memorizzato nulla.

. Punto decimale. Il primo carattere «.» nella stringa di formattazione determina la posizione del separatore decimale nel valore formattato; eventuali caratteri «.» aggiuntivi vengono ignorati. Il carattere effettivamente utilizzato come separatore decimale nella stringa di output è determinato dalla variabile globale DecimalSeparator. Il valore predefinito di "Separatore decimale" è specificato nella sezione "Formato dei numeri" della scheda "Internazionale" nel Pannello di controllo di Windows.

, Separatore delle migliaia. Se la stringa di formattazione contiene uno o più caratteri «,», nell'output verranno inseriti dei separatori delle migliaia tra ogni gruppo di tre cifre a sinistra della virgola decimale. La posizione e il numero dei caratteri «,» nella stringa di formato non influiscono sul risultato, se non per indicare che si desidera l'inserimento di separatori delle migliaia. Il carattere effettivamente utilizzato come separatore delle migliaia nell'output è determinato dalla variabile globale ThousandSeparator. Il valore predefinito di "Separatore delle migliaia" è specificato nelle impostazioni di "Formato dei numeri" della sezione "Internazionale" nel Pannello di controllo di Windows.

E+ Notazione scientifica. Se la stringa di formato contiene una delle stringhe "E+", "E-", "e+" o "e-", il numero viene formattato in notazione scientifica. Dopo i simboli «E+», «E-», «e+» o «e-» può seguire immediatamente un gruppo di massimo quattro caratteri «0» per determinare il numero minimo di cifre dell'esponente. I formati «E+» ed «e+» fanno sì che venga visualizzato un segno più per gli esponenti positivi e un segno meno per quelli negativi. I formati "E-" e "e-" visualizzano il segno solo per gli esponenti negativi.

I caratteri "xx" racchiusi tra virgolette singole o doppie vengono visualizzati così come sono e non influiscono sulla formattazione.

; Separa le sezioni relative ai numeri positivi, negativi e pari a zero nella stringa di formato.

La posizione dello "0" più a sinistra prima della virgola decimale nella stringa di formato e dello "0" più a destra dopo la virgola decimale nella stringa di formato determinano l'intervallo di cifre che sono sempre presenti nella stringa di output.

Il numero sottoposto a formattazione viene sempre arrotondato al numero di cifre decimali corrispondente al numero di caratteri di riempimento («0» o «#») presenti a destra del punto decimale. Se la stringa di formattazione non contiene il punto decimale, il valore da formattare viene arrotondato al numero intero più vicino.

Se il numero da formattare presenta più cifre a sinistra del separatore decimale rispetto al numero di segnaposto per le cifre presenti a sinistra del carattere «.» nella stringa di formattazione, le cifre in eccesso vengono visualizzate prima del primo segnaposto per le cifre.

Per consentire diversi formati per i valori positivi, negativi e pari a zero, la stringa di formattazione può contenere da una a tre sezioni separate da punti e virgola.

Una sezione: la stringa di formattazione si applica a tutti i valori.

Due sezioni: la prima sezione si applica ai valori positivi e allo zero, mentre la seconda sezione si applica ai valori negativi.

Tre sezioni: la prima riguarda i valori positivi, la seconda i valori negativi e la terza gli zeri.

Se la sezione dedicata ai valori negativi o quella dedicata ai valori pari a zero è vuota, ovvero se non c'è nulla tra i punti e virgola che delimitano la sezione, viene utilizzata invece la sezione dedicata ai valori positivi.

Se la sezione dedicata ai valori positivi è vuota, oppure se l'intera stringa di formattazione è vuota, il valore viene formattato utilizzando la formattazione generale in virgola mobile con 15 cifre significative, corrispondente a una chiamata a FloatToStrF con il formato ffGeneral. La formattazione standard in virgola mobile viene utilizzata anche se il valore ha più di 18 cifre a sinistra della virgola decimale e la stringa di formattazione non specifica la notazione scientifica. |