float_negate

Conceitos

Números de Ponto Flutuante (XFL)

Comportamento

C

• Multiplica um XFL por -1
• Retorna um novo XFL como um int64_t

JavaScript

• Nega uma representação de float.
• Retorna um código de erro ou o float negado como um bigint.

Definição

C

int64_t float_negate (
    int64_t float1
);

JavaScript

function float_negate(f1: bigint): ErrorCode | bigint

Exemplo

C

int64_t negative_one =
    float_negate(float_one());

Caso especial

A negação do Canonical Zero é o próprio Canonical Zero. Diferentemente de alguns padrões de ponto flutuante (como o IEEE), não existe “zero negativo” no XFL.

JavaScript

const negative_one =
    float_negate(float_one());

Parâmetros

C

Nome	Tipo	Descrição
float1	int64_t	Um número de ponto flutuante de envoltório XFL

JavaScript

Nome	Tipo	Descrição
f1	bigint	O float a ser negado.

Código de Retorno

C

Tipo	Descrição
int64_t	O número de envoltório XFL (xls17) Se negativo, um erro: INVALID_FLOAT - um dos parâmetros fornecidos não era um número de envoltório XFL válido

JavaScript

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