Formata um valor de ponto flutuante.

Estrutura

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

Parâmetros

Valor de retorno

Descrição

A função FormatFloat formata o valor de ponto flutuante fornecido por Value utilizando a cadeia de formatação fornecida por Format. Os seguintes especificadores de formato são suportados na cadeia de formato:

O especificador representa um marcador de posição de 0 dígitos

. Se o valor a ser formatado tiver um dígito na posição em que o «0» aparece na cadeia de formatação, esse dígito é copiado para a cadeia de saída. Caso contrário, é armazenado um «0» nessa posição na cadeia de saída.

Símbolo de preenchimento para dígitos. Se o valor a ser formatado tiver um dígito na posição em que o símbolo «#» aparece na cadeia de formatação, esse dígito é copiado para a cadeia de saída. Caso contrário, nada é armazenado nessa posição na cadeia de saída.

. Ponto decimal. O primeiro caractere «.» na cadeia de formatação determina a posição do separador decimal no valor formatado; quaisquer caracteres «.» adicionais são ignorados. O caractere efetivamente utilizado como separador decimal na cadeia de caracteres de saída é determinado pela variável global DecimalSeparator. O valor predefinido de «DecimalSeparator» é especificado na opção «Formato numérico» da secção «Internacional» no Painel de Controlo do Windows.

, Separador de milhares. Se a cadeia de formato contiver um ou mais caracteres «,», serão inseridos separadores de milhares entre cada grupo de três dígitos à esquerda da vírgula decimal. A posição e o número de caracteres «,» na cadeia de formatação não afetam o resultado, exceto para indicar que se pretende utilizar separadores de milhares. O caractere efetivamente utilizado como separador de milhares na saída é determinado pela variável global ThousandSeparator. O valor predefinido de «ThousandSeparator» é especificado na opção «Formato numérico» da secção «Internacional» no Painel de Controlo do Windows.

E+ Notação científica. Se a cadeia de caracteres contiver qualquer uma das seguintes expressões: «E+», «E-», «e+» ou «e-», o número será formatado utilizando notação científica. Um grupo de até quatro caracteres «0» pode seguir-se imediatamente aos caracteres «E+», «E-», «e+» ou «e-» para determinar o número mínimo de dígitos no expoente. Os formatos «E+» e «e+» fazem com que seja apresentado um sinal de mais para expoentes positivos e um sinal de menos para expoentes negativos. Os formatos «E-» e «e-» apresentam um caractere de sinal apenas para expoentes negativos.

Os caracteres «xx»/«xx» entre aspas simples ou duplas são apresentados tal como estão e não afetam a formatação.

; Separa as secções para números positivos, negativos e nulos na cadeia de formato.

A posição do «0» mais à esquerda antes da vírgula decimal na cadeia de formatação e a posição do «0» mais à direita após a vírgula decimal na cadeia de formatação determinam o intervalo de dígitos que estão sempre presentes na cadeia de saída.

O número que está a ser formatado é sempre arredondado para o mesmo número de casas decimais que houver espaços reservados para dígitos («0» ou «#») à direita do ponto decimal. Se a cadeia de formatação não contiver ponto decimal, o valor a ser formatado é arredondado para o número inteiro mais próximo.

Se o número a ser formatado tiver mais dígitos à esquerda do separador decimal do que o número de marcadores de dígitos à esquerda do caractere «.» na cadeia de formatação, os dígitos adicionais são apresentados antes do primeiro marcador de dígitos.

Para permitir diferentes formatos para valores positivos, negativos e nulos, a cadeia de formato pode conter entre uma e três secções separadas por ponto e vírgula.

Uma secção: A cadeia de formatação aplica-se a todos os valores.

Duas secções: a primeira secção aplica-se a valores positivos e zeros, e a segunda secção aplica-se a valores negativos.

Três secções: a primeira secção aplica-se a valores positivos, a segunda a valores negativos e a terceira a zeros.

Se a secção para valores negativos ou a secção para valores nulos estiver vazia, ou seja, se não houver nada entre os pontos e vírgulas que delimitam a secção, será utilizada, em vez disso, a secção para valores positivos.

Se a secção para valores positivos estiver vazia, ou se toda a cadeia de formatação estiver vazia, o valor é formatado utilizando a formatação geral de ponto flutuante com 15 dígitos significativos, o que corresponde a uma chamada à função FloatToStrF com o formato ffGeneral. A formatação geral de pontos flutuantes também é utilizada se o valor tiver mais de 18 dígitos à esquerda da vírgula decimal e a cadeia de formatação não especificar notação científica. |