float_root

Conceitos

Números de Ponto Flutuante (XFL)

Comportamento

C

• Calcula a raiz n-ésima de um número XFL
• Retorna o novo XFL

Cuidado

Devido a restrições de desempenho, float_root converte o argumento para um ponto flutuante de precisão dupla IEEE base-2 antes de aplicar a raiz n-ésima. Portanto, o resultado retornado frequentemente conterá menos precisão do que o esperado. Se você precisar de maior precisão, considere dividir seu XFL em um produto alto e um produto baixo, depois calcule individualmente as raízes quadradas desses produtos e multiplique os resultados entre si.

JavaScript

• Calcula a raiz n-ésima de uma representação de float.
• Um código de erro ou a raiz resultante como um bigint.

Definição

C

int64_t float_root (
    int64_t float1,
    uint32_t n
);

JavaScript

function float_root(f1: bigint, n: number): ErrorCode | bigint

Exemplo

C

int64_t three =
    float_root(nine, 2);

Cuidado

Se um número negativo for passado, a função retornará COMPLEX_NOT_SUPPORTED se a raiz for uma raiz par.

JavaScript

const three =
  float_root(nine, 2)

Parâmetros

C

Nome	Tipo	Descrição
float1	int64_t	Um número de ponto flutuante de envoltório XFL representando o número de ponto flutuante do qual calcular a raiz quadrada
n	uint32_t	A raiz a ser calculada, por exemplo 2 é uma raiz quadrada.

JavaScript

Nome	Tipo	Descrição
f1	bigint	O float do qual calcular a raiz.
n	number	O grau da raiz a ser calculada.

Código de Retorno

C

Tipo	Descrição
int64_t	A raiz n-ésima calculada Se negativo, um erro: INVALID_FLOAT - o parâmetro fornecido não era um número de envoltório XFL válido COMPLEX_NOT_SUPPORTED - o parâmetro fornecido era um número negativo, o que resultaria em uma raiz complexa.

JavaScript

Tipo	Descrição
bigint ou ErrorCode	Retorna um código de erro ou a raiz resultante como um bigint.