float_mulratio

Conceptos

Números de punto flotante (XFL)

Comportamiento

C

• Calcula la multiplicación de un número de punto flotante XFL (xls17) por el cociente de dos enteros
• Devuelve un nuevo XFL como un int64_t

JavaScript

• Multiplica un número flotante por una razón definida por un numerador y un denominador.
• Devuelve un código de error o un nuevo XFL como bigint.

Definición

C

int64_t float_mulratio (
    int64_t float1,
    uint32_t round_up,
    uint32_t numerator,
    uint32_t denominator
);

JavaScript

function float_mulratio(
    f1: bigint,
    round_up: number,
    numerator: number,
    denominator: number
  ): ErrorCode | bigint

Ejemplo

C

int64_t max_vault_pusd =
    float_mulratio(max_vault_pusd, 0,
        COLLATERALIZATION_NUMERATOR, COLLATERALIZATION_DENOMINATOR);

JavaScript

const max_vault_pusd =
    float_mulratio(max_vault_pusd, 0,
        COLLATERALIZATION_NUMERATOR, COLLATERALIZATION_DENOMINATOR);

Parámetros

C

Nombre	Tipo	Descripción
float1	int64_t	Número XFL que representa el primer operando de la multiplicación
round_up	uint32_t	Si es distinto de cero, todos los cálculos se redondean hacia arriba
numerator	uint32_t	Numerador del cociente por el cual se multiplicará el valor flotante
denominator	uint32_t	Denominador del cociente por el cual se multiplicará el valor flotante

Precaución

Algunas multiplicaciones pueden producir overflow, lo que devuelve un error INVALID_FLOAT. Sin embargo, un underflow devuelve XFL Cero Canónico (es decir, número = 0).

JavaScript

Nombre	Tipo	Descripción
f1	bigint	Número XFL que representa el primer operando de la multiplicación
round_up	number	Si es distinto de cero, todos los cálculos se redondean hacia arriba
numerator	number	Numerador del cociente por el cual se multiplicará el valor flotante
denominator	number	Denominador del cociente por el cual se multiplicará el valor flotante

Código de retorno

C

Tipo	Descripción
int64_t	El número XFL (xls17) resultante Si es negativo, error: INVALID_FLOAT - alguno de los parámetros no es un número XFL válido OVERFLOW - el resultado es demasiado grande para representarse en XFL DIVISION_BY_ZERO - el denominador es cero.

JavaScript

Tipo	Descripción
ErrorCode o bigint	Devuelve un código de error o el número XFL (xls17) resultante