Fonctions log, logf et logl

Entête à inclure

#include <math.h>  // <cmath> en C++

Fonctions log, logf et logl

double log( double x );

float logf( float x );                      // C99

long double logl( long double x );          // C99

Ces trois fonctions permettent de calculer le logarithme naturel, aussi appelé logarithme népérien, de la valeur passée en paramètre. Le logarithme naturel (ou népérien) est dit de base e car ln(e) = 1.

La différence entre ces trois fonctions réside dans le type de données utilisé pour le paramètre et la valeur de retour (double, float ou long double). Les fonctions logf et logl ont été ajoutées dans C99.

Paramètre

• x: la valeur pour laquelle calculer le logarithme népérien.

Valeur de retour

• Ces fonctions renvoient le logarithme naturel de la valeur spécifiée en paramètre.

• Si x est une valeur négative, ces fonctions renvoient une valeur NaN et la variable errno sera initialisée à la valeur EDOM.

• Si x est nulle, ces fonctions renvoient une valeur infinie et la variable errno sera initialisée à la valeur ERANGE.

Exemple de code

 1 
 2 
 3 
 4 
 5 
 6 
 7 
 8 
 9 
 10 
 11 
 12 
 13 
 14 
 15 
 16 
 17 
 18 
 19 
 20 
 21 
 22 
 23 
 24 
 25 
 26 
 27 

#include <errno.h>
#include <math.h>
#include <stdio.h>
#include <stdlib.h>

int main() {

    double ln = log( M_E );
    printf( "log(e) == %g\n", ln );

    ln = log( pow( M_E, 2 ) );
    printf( "log(e²) == %g\n", ln );    

    ln = log( -1 );
    printf( "log(-1) == %g\n", ln );
    if ( isnan( ln ) ) {
        printf( "log(-1) - errno == EDOM: %d\n", errno == EDOM );
    }

    ln = log( 0 );
    printf( "log(0) == %g\n", ln );
    if ( isinf( ln ) ) {
        printf( "log(0) - errno == ERANGE: %d\n", errno == ERANGE );
    }

    return EXIT_SUCCESS;
}

Il est à noter que la librairie mathématique doit être ajoutée durant l'étape de "link" (édition des liens) de votre exécutable. Cela se réalise en ajoutant l'option -lm à votre compilateur GCC. En cas d'utilisation d'un autre compilateur, je vous renvoie vers la documentation de ce dernier.

$> gcc -o sample sample.c -lm
$> ./sample
log(e) == 1
log(e²) == 2
log(-1) == -nan
log(-1) - errno == EDOM: 1
log(0) == -inf
log(0) - errno == ERANGE: 1
$>

Sujets connexes