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

Paramètres

Valeur de retour

Si aucune erreur ne se produit e num
-1 est retourné.

Si une erreur de plage due à un dépassement de capacité se produit, +HUGE_VAL , +HUGE_VALF , ou +HUGE_VALL est renvoyé.

Si une erreur de plage se produit en raison d'un dépassement inférieur, le résultat correct (après arrondi) est retourné.

Gestion des erreurs

Les erreurs sont signalées comme spécifié dans math_errhandling .

Si l'implémentation prend en charge l'arithmétique à virgule flottante IEEE (IEC 60559),

• Si l'argument est ±0, il est retourné, non modifié.
• Si l'argument est -∞, -1 est retourné.
• Si l'argument est +∞, +∞ est retourné.
• Si l'argument est NaN, NaN est retourné.

Notes

Les fonctions std::expm1 et std::log1p sont utiles pour les calculs financiers, par exemple, lors du calcul de petits taux d'intérêt quotidiens : (1+x) n
-1 peut être exprimé comme std :: expm1 ( n * std:: log1p ( x ) ) . Ces fonctions simplifient également l'écriture précise des fonctions hyperboliques inverses.

Pour le type compatible IEEE double , un dépassement de capacité est garanti si 709.8 < num .

Les surcharges supplémentaires ne sont pas requises d'être fournies exactement comme (A) . Elles doivent seulement être suffisantes pour garantir que pour leur argument num de type entier, std :: expm1 ( num ) ait le même effet que std :: expm1 ( static_cast < double > ( num ) ) .

Exemple

#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'
              << "Intérêts gagnés en 2 jours sur 100$, composés quotidiennement à 1%\n"
              << "    sur un calendrier 30/360 = "
              << 100 * std::expm1(2 * std::log1p(0.01 / 360)) << '\n'
              << "exp(1e-16)-1 = " << std::exp(1e-16) - 1
              << ", mais expm1(1e-16) = " << std::expm1(1e-16) << '\n';
    // valeurs spéciales
    std::cout << "expm1(-0) = " << std::expm1(-0.0) << '\n'
              << "expm1(-Inf) = " << std::expm1(-INFINITY) << '\n';
    // gestion des erreurs
    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 déclenchée\n";
}

expm1(1) = 1.71828
Intérêts gagnés en 2 jours sur 100$, composés quotidiennement à 1%
    sur un calendrier 30/360 = 0.00555563
exp(1e-16)-1 = 0, mais expm1(1e-16) = 1e-16
expm1(-0) = -0
expm1(-Inf) = -1
expm1(710) = inf
    errno == ERANGE: Résultat trop grand
    FE_OVERFLOW déclenchée

Voir aussi