std::cbrt, std::cbrtf, std::cbrtl

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación (C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de apoyo de concurrencia (C++11)

Biblioteca de apoyo de ejecución (C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca numérica

Funciones matemáticas comunes
Funciones matemáticas especiales (C++17)
Constantes matemáticas (C++20)
Algoritmos básicos de álgebra lineal (C++26)
Entorno de punto flotante (C++11)
Números complejos
Arrays numéricos
Generación de números pseudoaleatorios
Operaciones de factores
gcd (C++17)
lcm (C++17)
Interpolaciones
midpoint (C++20)
lerp (C++20)
Saturación aritmética
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
Operaciones numéricas genéricas
iota (C++11)
ranges::iota (C++23)
accumulate
inner_product
adjacent_difference
partial_sum
reduce (C++17)
transform_reduce (C++17)
inclusive_scan (C++17)
exclusive_scan (C++17)
transform_inclusive_scan (C++17)
transform_exclusive_scan (C++17)
Operaciones de bits
bit_cast (C++20)
byteswap (C++23)
has_single_bit (C++20)
bit_ceil (C++20)
bit_floor (C++20)
bit_width (C++20)
rotl (C++20)
rotr (C++20)
countl_zero (C++20)
countl_one (C++20)
countr_zero (C++20)
countr_one (C++20)
popcount (C++20)
endian (C++20)

 

Funciones matemáticas comunes

Funciones
Operaciones básicas
abs(int)labsllabsimaxabs (C++11) abs(float)fabs divldivlldivimaxdiv (C++11) fmod	remainder (C++11) remquo (C++11) fma (C++11) fmax (C++11) fmin (C++11) fdim (C++11) nannanfnanl (C++11)(C++11)(C++11)
Funciones exponenciales
exp exp2 (C++11) expm1 (C++11)	log log10 log1p (C++11) log2 (C++11)
Funciones de potencias
sqrt cbrt (C++11)	hypot (C++11) pow
Funciones trigonométricas e hiperbólicas
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C++11) acosh (C++11) atanh (C++11)

Funciones de error y gamma
erf (C++11) erfc (C++11)	lgamma (C++11) tgamma (C++11)
Operaciones de punto flotante del entero más cercano
ceil floor roundlroundllround (C++11)(C++11)(C++11)	trunc (C++11) nearbyint (C++11) rintlrintllrint (C++11)(C++11)(C++11)
Funciones de manipulación de punto flotante
ldexp scalbnscalbln (C++11)(C++11) ilogb (C++11) logb (C++11)	frexp modf nextafternexttoward (C++11)(C++11) copysign (C++11)
Clasificación/comparación
fpclassify (C++11) isfinite (C++11) isinf (C++11) isnan (C++11) isnormal (C++11) signbit (C++11)	isgreater (C++11) isgreaterequal (C++11) isless (C++11) islessequal (C++11) islessgreater (C++11) isunordered (C++11)
Constantes de macro
HUGE_VALFHUGE_VALHUGE_VALL (C++11)(C++11) INFINITY (C++11) NAN (C++11) math_errhandlingMATH_ERRNOMATH_ERREXCEPT (C++11)	FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C++11)(C++11)(C++11)(C++11)(C++11)

 

<tbody> </tbody>

Definido en el archivo de encabezado <cmath>
float cbrt ( float arg ); float cbrtf( float arg );	(1)	(desde C++11)
double cbrt ( double arg );	(2)	(desde C++11)
long double cbrt ( long double arg ); long double cbrtl( long double arg );	(3)	(desde C++11)
double cbrt ( TipoEntero arg );	(4)	(desde C++11)

1-3) Calcula la raíz cúbica de arg.

4) Un conjunto de sobrecargas o una plantilla de función que acepta un argumento de cualquier tipo entero. Equivalente a 2) (el argumento se convierte a double).

Parámetros

arg

-

Valor de un tipo de punto flotante o un tipo entero.

Valor de retorno

See More

Si no se producen errores, se devuelve la raíz cúbica de arg (\(\small{\sqrt[3]{arg} }\)3√arg).

Si se produce un error debido a subdesbordamiento, se devuelve el resultado correcto (después del redondeo).

Manejo de errores

Los errores se informan como se especifica en math_errhandling

Si la implementación admite la aritmética de punto flotante IEEE (IEC 60559):

• Si el argumento es +0, -0, +∞, o -∞, se devuelve +0, -0, +∞, o -∞, respectivamente.
• Si el argumento es NaN, se devuelve NaN.

Notas

std::cbrt(arg) no es equivalente a std::pow(arg, 1.0/3) porque el número racional \(\small{\frac1{3} }\)

1

3

generalmente no es igual a 1.0/3 y std::pow no puede elevar una base negativa a un exponente fraccionario. Además, std::cbrt(arg) suele dar resultados más precisos que std::pow(arg, 1.0/3) (véase el ejemplo).

Ejemplo

Ejecuta este código

#include <iostream>
#include <iomanip>
#include <cmath>
#include <limits>

int main()
{
    std::cout
        << "Uso normal:\n"
        << "cbrt(729)       = " << std::cbrt(729) << '\n'
        << "cbrt(-0.125)    = " << std::cbrt(-0.125) << '\n'
        << "Special values:\n"
        << "cbrt(-0)        = " << std::cbrt(-0.0) << '\n'
        << "cbrt(+inf)      = " << std::cbrt(INFINITY) << '\n'
        << "Precisión y comparación con `pow`:\n"
        << std::setprecision(std::numeric_limits<double>::max_digits10)
        << "cbrt(343)       = " << std::cbrt(343) << '\n'
        << "pow(343,1.0/3)  = " << std::pow(343, 1.0/3) << '\n'
        << "cbrt(-343)      = " << std::cbrt(-343) << '\n'
        << "pow(-343,1.0/3) = " << std::pow(-343, 1.0/3) << '\n';
}

Posible salida:

Uso normal:
cbrt(729)       = 9
cbrt(-0.125)    = -0.5
Special values:
cbrt(-0)        = -0
cbrt(+inf)      = inf
Precisión y comparación con `pow`:
cbrt(343)       = 7
pow(343,1.0/3)  = 6.9999999999999991
cbrt(-343)      = -7
pow(-343,1.0/3) = -nan

Véase también

powpowfpowl (C++11)(C++11)	Eleva un número a la potencia dada (\(\small{x^y}\)xy) (función)
sqrtsqrtfsqrtl (C++11)(C++11)	Calcula la raíz cuadrada (\(\small{\sqrt{x} }\)√x) (función)
hypothypotfhypotl (C++11)(C++11)(C++11)	Calcula la raíz cuadrada de la suma de los cuadrados de dos o tres (C++17) números dados (\(\scriptsize{\sqrt{x^2+y^2} }\)√x2 +y2 ), (\(\scriptsize{\sqrt{x^2+y^2+z^2} }\)√x2 +y2 +z2 ) (función)
Documentación de C para cbrt