log2, log2f, log2l

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

數值

常用數學函式

浮點環境 (C99)

偽隨機數生成

複數運算 (C99)

型別通用數學 (C99)

位操作 (C23)

檢查整數運算 (C23)

 

常用數學函式

函式 基本操作 abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) 最大值/最小值操作 fmax (C99) fmin (C99) fmaximum (C23) fminimum (C23) fmaximum_mag (C23)  fmaximum_num (C23) fminimum_mag (C23) fminimum_num (C23) fmaximum_mag_num (C23) fminimum_mag_num (C23)   指數函式 exp exp10 (C23) exp2 (C99) expm1 (C99) exp10m1 (C23) exp2m1 (C23) log log10 log2 (C99) log1plogp1 (C99)(C23) log10p1 (C23) log2p1 (C23) 冪函式 sqrt cbrt (C99) rootn (C23) rsqrt (C23) hypot (C99) compound (C23) pow pown (C23) powr (C23) 三角函式和雙曲函式 sin cos tan asin acos atan atan2 sinpi (C23) cospi (C23) tanpi (C23) asinpi (C23) acospi (C23) atanpi (C23) atan2pi (C23) sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)

最近整數浮點數 ceil floor roundlroundllround (C99)(C99)(C99) roundeven (C23) trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99) fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23) 浮點數操作 ldexp frexp scalbnscalbln (C99)(C99) ilogbllogb (C99)(C23) logb (C99) modf nextafternexttoward (C99)(C99) nextupnextdown (C23)(C23) copysign (C99) canonicalize (C23) 窄化操作 fadd (C23) fsub (C23) fmul (C23) fdiv (C23) ffma (C23) fsqrt (C23) 量子與量子指數 quantizedN (C23) quantumdN (C23) samequantumdN (C23) llquantexpdN (C23) 十進位制重新編碼函式 encodedecdN (C23) decodedecdN (C23) encodebindN (C23) decodebindN (C23) 總序和載荷函式 totalorder (C23) getpayload (C23) setpayload (C23) setpayloadsig (C23) 分類 fpclassify (C99) iscanonical (C23)  isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99) issubnormal (C23) iszero (C23) isgreater (C99) isgreaterequal (C99)   isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99) issignaling (C23) iseqsig (C23)

誤差函式和伽馬函式 erf (C99) erfc (C99) lgamma (C99) tgamma (C99) 型別 div_tldiv_tlldiv_timaxdiv_t (C99)(C99) float_tdouble_t (C99)(C99) _Decimal32_t_Decimal64_t (C23)(C23) 宏常量 特殊浮點值 HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) 引數和返回值 FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99) FP_LLOGB0FP_LLOGBNAN (C23)(C23) FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23) 錯誤處理 MATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)  math_errhandling (C99) 快速操作指示符 FP_FAST_FMAFFP_FAST_FMA (C99)(C99) FP_FAST_FADDFP_FAST_FADDLFP_FAST_DADDLFP_FAST_DMADDDN (C23)(C23)(C23)(C23) FP_FAST_FMULFP_FAST_FMULLFP_FAST_DMULLFP_FAST_DMMULDN (C23)(C23)(C23)(C23) FP_FAST_FFMAFP_FAST_FFMALFP_FAST_DFMALFP_FAST_DMFMADN (C23)(C23)(C23)(C23) FP_FAST_FMALFP_FAST_FMADN (C99)(C23) FP_FAST_FSUBFP_FAST_FSUBLFP_FAST_DSUBLFP_FAST_DMSUBDN (C23)(C23)(C23)(C23) FP_FAST_FDIVFP_FAST_FDIVLFP_FAST_DDIVLFP_FAST_DMDIVDN (C23)(C23)(C23)(C23) FP_FAST_FSQRTFP_FAST_FSQRTLFP_FAST_DSQRTLFP_FAST_DMSQRTDN (C23)(C23)(C23)(C23)

 

定義於標頭檔案 <math.h>
float       log2f( float arg );	(1)	(C99 起)
double      log2( double arg );	(2)	(C99 起)
long double log2l( long double arg );	(3)	(C99 起)
定義於標頭檔案 <tgmath.h>
#define log2( arg )	(4)	(C99 起)

1-3) 計算 arg 的底數為 2 的對數。

4) 型別泛型宏：若 arg 型別為 long double，則呼叫 log2l。否則，若 arg 為整型或 double 型別，則呼叫 log2。否則，呼叫 log2f。

引數

arg

-

浮點值

返回值

若無錯誤發生，則返回 arg 的底數為 2 的對數（log2(arg) 或 lb(arg)）。

如果發生域錯誤，則返回實現定義的值 (支援 NaN 時返回 NaN)。

若發生極點錯誤，則返回 -HUGE_VAL、-HUGE_VALF 或 -HUGE_VALL。

錯誤處理

錯誤按 math_errhandling 中指定的方式報告。

若 arg 小於零，則發生定義域錯誤。

若 arg 為零，則可能發生極點錯誤。

如果實現支援 IEEE 浮點運算 (IEC 60559)，

• 若引數為 ±0，則返回 -∞ 並引發 FE_DIVBYZERO。
• 若引數為 1，則返回 +0。
• 若引數為負數，則返回 NaN 並引發 FE_INVALID。
• 如果引數為 +∞，則返回 +∞
• 如果引數為 NaN，則返回 NaN

注意

對於整型 arg，二進位制對數可以解釋為輸入中最高有效位的 1 的零基索引。

示例

執行此程式碼

#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");
}

可能的輸出

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

參考

• C17 標準 (ISO/IEC 9899:2018)

• 7.12.6.10 log2 函式 (p: 179)

• 7.25 型別通用數學 <tgmath.h> (p: 272-273)

• F.10.3.10 log2 函式 (p: 381)

• C11 標準 (ISO/IEC 9899:2011)

• 7.12.6.10 log2 函式 (p: 246)

• 7.25 型別通用數學 <tgmath.h> (p: 373-375)

• F.10.3.10 log2 函式 (p: 522)

• C99 標準 (ISO/IEC 9899:1999)

• 7.12.6.10 log2 函式 (p: 226)

• 7.22 型別通用數學 <tgmath.h> (p: 335-337)

• F.9.3.10 log2 函式 (p: 459)

亦參見

loglogflogl (C99)(C99)	計算自然（底數e）對數 (\({\small \ln{x} }\)ln(x)) (函式)
log10log10flog10l (C99)(C99)	計算常用（底數10）對數 (\({\small \log_{10}{x} }\)log10(x)) (函式)
log1plog1pflog1pl (C99)(C99)(C99)	計算1加上給定數的自然（底數e）對數 (\({\small \ln{(1+x)} }\)ln(1+x)) (函式)
exp2exp2fexp2l (C99)(C99)(C99)	計算 2 的給定冪 (\({\small 2^x}\)2x) (函式)
C++ 文件 用於 log2