Formatea un valor de punto flotante.

Estructura

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

Parámetros

Valor devuelto

Descripción

FormatFloat formatea el valor de punto flotante proporcionado por Value utilizando la cadena de formato indicada por Format. En la cadena de formato se admiten los siguientes especificadores de formato:

El especificador representa un marcador de posición de 0 dígitos en

. Si el valor que se va a formatear contiene un dígito en la posición en la que aparece el «0» en la cadena de formato, dicho dígito se copia en la cadena de salida. De lo contrario, se almacena un «0» en esa posición de la cadena de salida.

Marcador de posición para un dígito. Si el valor que se va a formatear contiene un dígito en la posición en la que aparece el símbolo «#» en la cadena de formato, dicho dígito se copia en la cadena de salida. De lo contrario, no se almacena nada en esa posición de la cadena de salida.

. Punto decimal. El primer carácter «.» de la cadena de formato determina la posición del separador decimal en el valor formateado; cualquier carácter «.» adicional se ignora. El carácter concreto que se utiliza como separador decimal en la cadena de salida viene determinado por la variable global DecimalSeparator. El valor predeterminado de «DecimalSeparator» se especifica en la opción «Formato numérico» de la sección «Internacional» del Panel de control de Windows.

, Separador de miles. Si la cadena de formato contiene uno o más caracteres «,», en la salida se insertarán separadores de miles entre cada grupo de tres dígitos a la izquierda del punto decimal. La ubicación y el número de caracteres «,» en la cadena de formato no afectan al resultado, salvo para indicar que se desean separadores de miles. El carácter concreto que se utiliza como separador de miles en la salida viene determinado por la variable global ThousandSeparator. El valor predeterminado de «ThousandSeparator» se especifica en la opción «Formato numérico» de la sección «Internacional» del Panel de control de Windows.

E+ Notación científica. Si la cadena de formato contiene alguna de las cadenas «E+», «E-», «e+» o «e-», el número se formatea utilizando notación científica. Tras los caracteres «E+», «E-», «e+» o «e-» puede aparecer inmediatamente un grupo de hasta cuatro caracteres «0» para determinar el número mínimo de dígitos del exponente. Los formatos «E+» y «e+» hacen que se muestre un signo más para los exponentes positivos y un signo menos para los exponentes negativos. Los formatos «E-» y «e-» muestran un signo solo cuando el exponente es negativo.

Los caracteres «xx»/«xx» entre comillas simples o dobles se muestran tal cual y no afectan al formato.

; Separa las secciones correspondientes a los números positivos, negativos y cero en la cadena de formato.

La posición del «0» situado más a la izquierda antes del punto decimal en la cadena de formato y la del «0» situado más a la derecha después del punto decimal en la cadena de formato determinan el rango de dígitos que siempre aparecen en la cadena de salida.

El número que se formatea siempre se redondea al mismo número de decimales que haya marcadores de posición («0» o «#») a la derecha del punto decimal. Si la cadena de formato no contiene ningún punto decimal, el valor que se formatea se redondea al número entero más cercano.

Si el número que se va a formatear tiene más dígitos a la izquierda del separador decimal de los que hay marcadores de posición a la izquierda del carácter «.» en la cadena de formato, los dígitos adicionales se muestran antes del primer marcador de posición.

Para permitir diferentes formatos para los valores positivos, negativos y cero, la cadena de formato puede contener entre una y tres secciones separadas por punto y coma.

Una sección: la cadena de formato se aplica a todos los valores.

Dos secciones: la primera se aplica a los valores positivos y a los ceros, y la segunda a los valores negativos.

Tres secciones: la primera se aplica a los valores positivos, la segunda a los valores negativos y la tercera a los ceros.

Si la sección de valores negativos o la de valores cero está vacía, es decir, si no hay nada entre los puntos y comas que delimitan la sección, se utiliza en su lugar la sección de valores positivos.

Si la sección de valores positivos está vacía, o si toda la cadena de formato está vacía, el valor se formatea utilizando el formato general de punto flotante con 15 dígitos significativos, lo que corresponde a una llamada a FloatToStrF con el formato ffGeneral. El formato general de coma flotante también se utiliza si el valor tiene más de 18 dígitos a la izquierda del punto decimal y la cadena de formato no especifica la notación científica. |