float_compare

Conceitos

Números de Ponto Flutuante (XFL)

Comportamento

C

• Avalia uma comparação entre dois números de ponto flutuante XFL
• Retorna o resultado da comparação como um booleano codificado em um int64_t.

JavaScript

• Avalia uma comparação entre dois números de ponto flutuante XFL
• Retorna um código de erro ou o resultado da comparação como um número.

Definição

C

int64_t float_compare (
    int64_t float1,
    int64_t float2,
    uint32_t mode
);

JavaScript

function float_compare(
    f1: bigint,
    f2: bigint,
    mode: number
  ): ErrorCode | number

Exemplo

C

if (float_compare(pusd_to_send, 0, COMPARE_LESS) == 1)
{
  // pusd_to_send is less than 0
}

JavaScript

if (float_compare(pusd_to_send, 0n, COMPARE_LESS) == 1)
{
  // pusd_to_send is less than 0
}

Parâmetros

C

Nome	Tipo	Descrição
float1	int64_t	Um número de ponto flutuante de envoltório XFL representando o primeiro operando da comparação
float2	int64_t	Um número de ponto flutuante de envoltório XFL representando o segundo operando da comparação
mode	uint32_t	Um campo de flags de bits composto por qualquer um (ou qualquer combinação logicamente válida) dos seguintes flags: COMPARE_EQUAL 1 COMPARE_LESS 2 COMPARE_GREATER 4 Combinações válidas são: COMPARE_LESS | COMPARE_GREATER - Diferente COMPARE_LESS | COMPARE_EQUAL - Menor ou igual a COMPARE_GREATER | COMPARE_EQUAL - Maior ou igual a

Cuidado

Sempre verifique se a função retornou 1 em vez de non-zero (diferente de zero), já que códigos de erro negativos também serão classificados como non-zero.

JavaScript

Nome	Tipo	Descrição
f1	bigint	O primeiro float a ser comparado.
f2	bigint	O segundo float a ser comparado.
mode	number	O modo de comparação (ex.: menor que, igual a, maior que).

Código de Retorno

C

Tipo	Descrição
int64_t	0 se a comparação foi logicamente falsa. 1 se a comparação foi logicamente verdadeira. Se negativo, um erro: INVALID_FLOAT - um dos parâmetros fornecidos não era um número de envoltório XFL válido INVALID_ARGUMENT - combinação inválida dos flags de comparação fornecidos.

JavaScript

Tipo	Descrição
ErrorCode ou number	Retorna um código de erro ou o resultado da comparação como um número.