std:: log1p, std:: log1pf, std:: log1pl

Paramètres

Valeur de retour

Si aucune erreur ne se produit ln(1+num) est retourné.

Si une erreur de domaine se produit, une valeur définie par l'implémentation est retournée (NaN là où supporté).

Si une erreur de pôle se produit, -HUGE_VAL , -HUGE_VALF , ou -HUGE_VALL est retourné.

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 .

Une erreur de domaine se produit si num est inférieur à -1 .

Une erreur de pôle peut se produire si num est -1 .

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

• Si l'argument est ±0, il est retourné inchangé.
• Si l'argument est -1, -∞ est retourné et FE_DIVBYZERO est déclenché.
• Si l'argument est inférieur à -1, NaN est retourné et FE_INVALID est déclenché.
• 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 de fonctions hyperboliques inverses précises.

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

Exemple

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::cout << "log1p(0) = " << log1p(0) << '\n'
              << "Intérêt gagné en 2 jours sur 100$, composé quotidiennement à 1%\n"
              << "    sur un calendrier 30/360 = "
              << 100 * expm1(2 * log1p(0.01 / 360)) << '\n'
              << "log(1+1e-16) = " << std::log(1 + 1e-16)
              << ", mais log1p(1e-16) = " << std::log1p(1e-16) << '\n';
    // valeurs spéciales
    std::cout << "log1p(-0) = " << std::log1p(-0.0) << '\n'
              << "log1p(+Inf) = " << std::log1p(INFINITY) << '\n';
    // gestion des erreurs
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "log1p(-1) = " << std::log1p(-1) << '\n';
    if (errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_DIVBYZERO))
        std::cout << "    FE_DIVBYZERO déclenchée\n";
}

log1p(0) = 0
Intérêt gagné en 2 jours sur 100$, composé quotidiennement à 1%
    sur un calendrier 30/360 = 0.00555563
log(1+1e-16) = 0, mais log1p(1e-16) = 1e-16
log1p(-0) = -0
log1p(+Inf) = inf
log1p(-1) = -inf
    errno == ERANGE: Résultat trop grand
    FE_DIVBYZERO déclenchée

Voir aussi