Namespaces
Variants

log2, log2f, log2l

From cppreference.net
< c ‎ | numeric ‎ | math
C
Numerics
Common mathematical functions
Functions
Basic operations
(C99)
(C99)
(C99)
(C99)
(C99) (C99) (C99) (C23)
Maximum/minimum operations
Exponential functions
log2
(C99)
(C99) (C23)
(C23)
(C23)
Power functions
Trigonometric and hyperbolic functions
Nearest integer floating-point
(C99)
(C99) (C99) (C99)
(C23) (C23) (C23) (C23)
Floating-point manipulation
Narrowing operations
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
Quantum and quantum exponent
Decimal re-encoding functions
Total order and payload functions
Classification
Error and gamma functions
(C99)
(C99)
(C99)
(C99)
Types
Macro constants
Special floating-point values
Arguments and return values
Error handling
Fast operation indicators
Défini dans l'en-tête <math.h>
float log2f ( float arg ) ;
(1) (depuis C99)
double log2 ( double arg ) ;
(2) (depuis C99)
long double log2l ( long double arg ) ;
(3) (depuis C99)
Défini dans l'en-tête <tgmath.h>
#define log2( arg )
(4) (depuis C99)
1-3) Calcule le logarithme en base 2 de arg .
4) Macro générique de type : Si arg a le type long double , log2l est appelé. Sinon, si arg a un type entier ou le type double , log2 est appelé. Sinon, log2f est appelé.

Table des matières

Paramètres

arg - valeur à virgule flottante

Valeur de retour

Si aucune erreur ne se produit, le logarithme en base 2 de arg ( log 2 (arg) ou lb(arg) ) 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é.

Gestion des erreurs

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

Une erreur de domaine se produit si arg est inférieur à zéro.

Une erreur de pôle peut se produire si arg est nul.

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

  • Si l'argument est ±0, -∞ est retourné et FE_DIVBYZERO est déclenché.
  • Si l'argument est 1, +0 est retourné
  • Si l'argument est négatif, NaN est retourné et FE_INVALID est déclenché.
  • Si l'argument est +∞, +∞ est retourné
  • Si l'argument est NaN, NaN est retourné

Notes

Pour un entier arg , le logarithme binaire peut être interprété comme l'indice de base zéro du bit le plus significatif à 1 dans l'entrée.

Exemple

Exécuter ce code 
#include <stdio.h>
#include <math.h>
#include <float.h>
#include <errno.h>
#include <fenv.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("log2(65536) = %f\n", log2(65536));
    printf("log2(0.125) = %f\n", log2(0.125));
    printf("log2(0x020f) = %f (highest set bit is in position 9)\n", log2(0x020f));
    printf("base-5 logarithm of 125 = %f\n", log2(125)/log2(5));
    // special values
    printf("log2(1) = %f\n", log2(1));
    printf("log2(+Inf) = %f\n", log2(INFINITY));
    //error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("log2(0) = %f\n", log2(0));
    if(errno == ERANGE) perror("    errno == ERANGE");
    if(fetestexcept(FE_DIVBYZERO)) puts("    FE_DIVBYZERO raised");
}

Sortie possible : 

log2(65536) = 16.000000
log2(0.125) = -3.000000
log2(0x020f) = 9.041659 (highest set bit is in position 9)
base-5 logarithm of 125 = 3.000000
log2(1) = 0.000000
log2(+Inf) = inf
log2(0) = -inf
    errno == ERANGE: Numerical result out of range
    FE_DIVBYZERO raised

Références

  • Norme C17 (ISO/CEI 9899:2018) :
  • 7.12.6.10 Les fonctions log2 (p: 179)
  • 7.25 Mathématiques génériques de type <tgmath.h> (p: 272-273)
  • F.10.3.10 Les fonctions log2 (p: 381)
  • Norme C11 (ISO/CEI 9899:2011) :
  • 7.12.6.10 Les fonctions log2 (p: 246)
  • 7.25 Mathématiques génériques <tgmath.h> (p: 373-375)
  • F.10.3.10 Les fonctions log2 (p: 522)
  • Norme C99 (ISO/CEI 9899:1999) :
  • 7.12.6.10 Les fonctions log2 (p: 226)
  • 7.22 Mathématiques génériques de type <tgmath.h> (p: 335-337)
  • F.9.3.10 Les fonctions log2 (p: 459)

Voir aussi

(C99) (C99)
calcule le logarithme naturel (base- e ) ( ln(x) )
(fonction)
(C99) (C99)
calcule le logarithme décimal (base- 10 ) ( log 10 (x) )
(fonction)
(C99) (C99) (C99)
calcule le logarithme naturel (base- e ) de 1 plus le nombre donné ( ln(1+x) )
(fonction)
(C99) (C99) (C99)
calcule 2 élevé à la puissance donnée ( 2 x )
(fonction)
Documentation C++ pour log2