expm1, expm1f, expm1l

Paramètres

Valeur de retour

Si aucune erreur ne se produit e arg
-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 expm1 et 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 expm1 ( n * log1p ( x ) ) . Ces fonctions simplifient également l'écriture de fonctions hyperboliques inverses précises.

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

Exemple

#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("expm1(1) = %f\n", expm1(1));
    printf("Intérêts gagnés en 2 jours sur 100$, composés quotidiennement à 1%%\n"
           " sur un calendrier 30/360 = %f\n",
           100*expm1(2*log1p(0.01/360)));
    printf("exp(1e-16)-1 = %g, mais expm1(1e-16) = %g\n",
           exp(1e-16)-1, expm1(1e-16));
    // valeurs spéciales
    printf("expm1(-0) = %f\n", expm1(-0.0));
    printf("expm1(-Inf) = %f\n", expm1(-INFINITY));
    // gestion d'erreur
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("expm1(710) = %f\n", expm1(710));
    if (errno == ERANGE)
        perror("    errno == ERANGE");
    if (fetestexcept(FE_OVERFLOW))
        puts("    FE_OVERFLOW raised");
}

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

Références

Voir aussi