◐ Shell
clean mode source ↗

std::exp2, std::exp2f, std::exp2l - cppreference.com

De cppreference.com

Definido en el archivo de encabezado <cmath>

float exp2 ( float n ); float exp2f( float n );

 (1) (desde C++11)

double exp2 ( double n );

 (2) (desde C++11)

long double exp2 ( long double n ); long double exp2l( long double n );

 (3) (desde C++11)

double exp2 ( TipoEntero n );

 (4) (desde C++11)

1-3) Calcula 2 elevado a la potencia dada n.

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

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

Valor de retorno

Si no se producen errores, se devuelve el exponencial base 2 de n (2n
).

Si se produce un error de rango debido a desbordamiento, se devuelve HUGE_VAL, +HUGE_VALF, o +HUGE_VALL.

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 o -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.

Ejemplo

#include <iostream>
#include <cmath>
#include <cerrno>
#include <cstring>
#include <cfenv>
// #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);
    std::cout << "exp2(1024) = " << std::exp2(1024) << '\n';
    if (errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_OVERFLOW))
        std::cout << "    Se generó FE_OVERFLOW\n";
}

Posible salida: 

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
    Se generó FE_OVERFLOW

Véase también