float_set

Conceitos

Números de Ponto Flutuante (XFL)

Comportamento

C

• Calcula um ponto flutuante XFL (xls17) a partir do expoente e da mantissa fornecidos
• Retorna esse XFL como um int64_t

JavaScript

• Define o expoente e a mantissa de uma representação de float.
• Retorna um código de erro ou um novo XFL como um bigint.

Definição

C

int64_t float_set (
    int32_t exponent,
    int64_t mantissa
);

JavaScript

function float_set(exponent: number, mantissa: number): ErrorCode | bigint

Exemplo

C

int64_t small_amount =
  float_set(-81, 1);

JavaScript

const small_amount = float_set(-81, 1);

Parâmetros

C

Nome	Tipo	Descrição
exponent	int32_t	Um expoente no intervalo de -96 a 80
mantissa	int64_t	Uma mantissa. Se negativa, o sinal do float é negativo.

Cuidado

Ao definir uma mantissa com mais ou menos de 16 dígitos decimais, o expoente será ajustado para garantir que a mantissa tenha exatamente 16 dígitos. Esse ajuste pode resultar em um INVALID_FLOAT em algumas circunstâncias.

Caso especial

O XFL canonical 0 também é 0 no número de envoltório. Portanto, nunca há necessidade de chamar float_set(0,0);

JavaScript

Nome	Tipo	Descrição
exponent	bigint	Um expoente no intervalo de -96 a 80
mantissa	bigint	Uma mantissa. Se negativa, o sinal do float é negativo.

Código de Retorno

C

Tipo	Descrição
int64_t	O número de envoltório XFL (xls17) Se negativo, um erro: INVALID_FLOAT - O ajuste da mantissa para 16 dígitos produziu um underflow ou overflow.

JavaScript

Tipo	Descrição
ErrorCode | bigint	Um código de erro ou o número de envoltório XFL (xls17).