float_set

Conceptos

Números de punto flotante (XFL)

Comportamiento

C

• Calcula un número de punto flotante XFL (xls17) a partir del exponente y la mantisa proporcionados
• Devuelve ese XFL como un int64_t

JavaScript

• Establece el exponente y la mantisa para una representación flotante.
• Devuelve un código de error o un nuevo XFL como bigint.

Definición

C

int64_t float_set (
    int32_t exponent,
    int64_t mantissa
);

JavaScript

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

Ejemplo

C

int64_t small_amount =
  float_set(-81, 1);

JavaScript

const small_amount = float_set(-81, 1);

Parámetros

C

Nombre	Tipo	Descripción
exponent	int32_t	Un exponente en el rango -96 a 80
mantissa	int64_t	Una mantisa. Si es negativa, el signo del número será negativo.

Precaución

Al establecer una mantisa con más o menos de 16 dígitos decimales, el exponente se ajustará para garantizar que la mantisa tenga exactamente 16 dígitos. Este ajuste puede provocar un INVALID_FLOAT en algunos casos.

Caso especial

El XFL canónico 0 también es 0 en el número contenedor. Por lo tanto, nunca es necesario llamar a float_set(0,0);

JavaScript

Nombre	Tipo	Descripción
exponent	bigint	Un exponente en el rango -96 a 80
mantissa	bigint	Una mantisa. Si es negativa, el signo del número será negativo.

Código de retorno

C

Tipo	Descripción
int64_t	El número XFL (xls17) Si es negativo, error: INVALID_FLOAT - El ajuste de la mantisa a 16 dígitos produjo un desbordamiento o subdesbordamiento.

JavaScript

Tipo	Descripción
ErrorCode | bigint	Un código de error o el número XFL (xls17).