std:: exp2, std:: exp2f, std:: exp2l
|
Definido en el encabezado
<cmath>
|
||
| (1) | ||
|
float
exp2
(
float
num
)
;
double
exp2
(
double
num
)
;
|
(hasta C++23) | |
|
/*floating-point-type*/
exp2 ( /*floating-point-type*/ num ) ; |
(desde C++23)
(constexpr desde C++26) |
|
|
float
exp2f
(
float
num
)
;
|
(2) |
(desde C++11)
(constexpr desde C++26) |
|
long
double
exp2l
(
long
double
num
)
;
|
(3) |
(desde C++11)
(constexpr desde C++26) |
|
Sobrecarga SIMD
(desde C++26)
|
||
|
Definido en el encabezado
<simd>
|
||
|
template
<
/*math-floating-point*/
V
>
constexpr
/*deduced-simd-t*/
<
V
>
|
(S) | (desde C++26) |
|
Sobrecargas adicionales
(desde C++11)
|
||
|
Definido en el encabezado
<cmath>
|
||
|
template
<
class
Integer
>
double exp2 ( Integer num ) ; |
(A) | (constexpr desde C++26) |
std::exp2
para todos los tipos de punto flotante sin calificación cv como el tipo del parámetro.
(desde C++23)
|
S)
La sobrecarga SIMD realiza un
std::exp2
elemento por elemento en
v_num
.
|
(desde C++26) |
|
A)
Se proporcionan sobrecargas adicionales para todos los tipos enteros, los cuales son tratados como
double
.
|
(since C++11) |
Contenidos |
Parámetros
| num | - | valor de punto flotante o entero |
Valor de retorno
Si no ocurren errores, la exponencial en base
2
de
num
(
2
num
) es devuelta.
Si ocurre un error de rango debido a desbordamiento,
+HUGE_VAL
,
+HUGE_VALF
, o
+HUGE_VALL
es devuelto.
Si se produce un error de rango debido a desbordamiento inferior, se devuelve el resultado correcto (después del redondeo).
Manejo de errores
Los errores se reportan como se especifica en math_errhandling .
Si la implementación soporta aritmética de punto flotante IEEE (IEC 60559),
- Si el argumento es ±0, se devuelve 1.
- Si el argumento es -∞, se devuelve +0.
- Si el argumento es +∞, se devuelve +∞.
- Si el argumento es NaN, se devuelve NaN.
Notas
Las sobrecargas adicionales no requieren ser proporcionadas exactamente como (A) . Solo necesitan ser suficientes para garantizar que para su argumento num de tipo entero, std :: exp2 ( num ) tenga el mismo efecto que std :: exp2 ( static_cast < double > ( num ) ) .
Para exponentes integrales, puede ser preferible usar std::ldexp .
Ejemplo
#include <cerrno> #include <cfenv> #include <cmath> #include <cstring> #include <iostream> // #pragma STDC FENV_ACCESS ON int main() { std::cout << "exp2(4) = " << std::exp2(4) << '\n' << "exp2(0.5) = " << std::exp2(0.5) << '\n' << "exp2(-4) = " << std::exp2(-4) << '\n'; // valores especiales std::cout << "exp2(-0) = " << std::exp2(-0.0) << '\n' << "exp2(-Inf) = " << std::exp2(-INFINITY) << '\n'; // manejo de errores errno = 0; std::feclearexcept(FE_ALL_EXCEPT); const double inf = std::exp2(1024); const bool is_range_error = errno == ERANGE; std::cout << "exp2(1024) = " << inf << '\n'; if (is_range_error) std::cout << " errno == ERANGE: " << std::strerror(ERANGE) << '\n'; if (std::fetestexcept(FE_OVERFLOW)) std::cout << " FE_OVERFLOW raised\n"; }
Salida posible:
exp2(4) = 16
exp2(0.5) = 1.41421
exp2(-4) = 0.0625
exp2(-0) = 1
exp2(-Inf) = 0
exp2(1024) = inf
errno == ERANGE: Resultado numérico fuera de rango
FE_OVERFLOW raised
Véase también
|
(C++11)
(C++11)
|
devuelve
e
elevado a la potencia dada (
e
x
)
(función) |
|
(C++11)
(C++11)
(C++11)
|
devuelve
e
elevado a la potencia dada, menos
1
(
e
x
-1
)
(función) |
|
(C++11)
(C++11)
|
multiplica un número por
2
elevado a una potencia entera
(función) |
|
(C++11)
(C++11)
(C++11)
|
logaritmo en base
2
del número dado (
log
2
(x)
)
(función) |
|
Documentación C
para
exp2
|
|