float_root

Conceptos

Números de punto flotante (XFL)

Comportamiento

C

• Calcula la raíz n-ésima de un número XFL
• Devuelve un nuevo XFL

Precaución

Debido a limitaciones de rendimiento, float_root convierte el argumento a un número de punto flotante IEEE base-2 de doble precisión antes de aplicar la raíz n-ésima. Por lo tanto, el resultado puede tener menos precisión de la esperada. Si necesitas mayor precisión, puedes dividir el XFL en una parte alta y una baja, calcular las raíces cuadradas por separado y luego multiplicar los resultados.

JavaScript

• Calcula la raíz n-ésima de una representación flotante.
• Devuelve un código de error o la raíz como bigint.

Definición

C

int64_t float_root (
    int64_t float1,
    uint32_t n
);

JavaScript

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

Ejemplo

C

int64_t three =
    float_root(nine, 2);

Precaución

Si se pasa un número negativo, la función devolverá COMPLEX_NOT_SUPPORTED si la raíz es de grado par.

JavaScript

const three =
  float_root(nine, 2)

Parámetros

C

Nombre	Tipo	Descripción
float1	int64_t	Número XFL del que se desea calcular la raíz
n	uint32_t	Grado de la raíz, por ejemplo 2 representa la raíz cuadrada

JavaScript

Nombre	Tipo	Descripción
f1	bigint	El número flotante del que calcular la raíz
n	number	El grado de la raíz a calcular

Código de retorno

C

Tipo	Descripción
int64_t	La raíz n-ésima calculada Si es negativo, error: INVALID_FLOAT - el parámetro no es un número XFL válido COMPLEX_NOT_SUPPORTED - el parámetro es negativo y daría lugar a una raíz compleja

JavaScript

Tipo	Descripción
bigint o ErrorCode	Devuelve un código de error o la raíz resultante