std:: expm1, std:: expm1f, std:: expm1l

Parámetros

Valor de retorno

Si no ocurren errores e num
-1 es retornado.

Si ocurre un error de rango debido a desbordamiento, +HUGE_VAL , +HUGE_VALF , o +HUGE_VALL es devuelto.

Si ocurre 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 sin modificar.
• Si el argumento es -∞, se devuelve -1.
• Si el argumento es +∞, se devuelve +∞.
• Si el argumento es NaN, se devuelve NaN.

Notas

Las funciones std::expm1 y std::log1p son útiles para cálculos financieros, por ejemplo, al calcular tasas de interés diarias pequeñas: (1+x) n
-1 puede expresarse como std :: expm1 ( n * std:: log1p ( x ) ) . Estas funciones también simplifican la escritura de funciones hiperbólicas inversas precisas.

Para el tipo compatible con IEEE double , se garantiza desbordamiento si 709.8 < num .

Las sobrecargas adicionales no están obligadas a proporcionarse exactamente como (A) . Solo necesitan ser suficientes para garantizar que para su argumento num de tipo entero, std :: expm1 ( num ) tenga el mismo efecto que std :: expm1 ( static_cast < double > ( num ) ) .

Ejemplo

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::cout << "expm1(1) = " << std::expm1(1) << '\n'
              << "Interés ganado en 2 días sobre $100, compuesto diariamente al 1%\n"
              << "    en un calendario 30/360 = "
              << 100 * std::expm1(2 * std::log1p(0.01 / 360)) << '\n'
              << "exp(1e-16)-1 = " << std::exp(1e-16) - 1
              << ", pero expm1(1e-16) = " << std::expm1(1e-16) << '\n';
    // valores especiales
    std::cout << "expm1(-0) = " << std::expm1(-0.0) << '\n'
              << "expm1(-Inf) = " << std::expm1(-INFINITY) << '\n';
    // manejo de errores
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "expm1(710) = " << std::expm1(710) << '\n';
    if (errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_OVERFLOW))
        std::cout << "    FE_OVERFLOW activada\n";
}

expm1(1) = 1.71828
Interés ganado en 2 días sobre $100, compuesto diariamente al 1%
    en un calendario 30/360 = 0.00555563
exp(1e-16)-1 = 0, pero expm1(1e-16) = 1e-16
expm1(-0) = -0
expm1(-Inf) = -1
expm1(710) = inf
    errno == ERANGE: Resultado demasiado grande
    FE_OVERFLOW activada

Véase también