名稱空間
變體
操作

log10, log10f, log10l

來自 cppreference.com
< c‎ | 數值‎ | 數學
 
 
 
常用數學函式
函式
基本操作
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大值/最小值操作
(C99)
(C99)
指數函式
(C23)
(C99)
(C99)
(C23)
(C23)

log10
(C99)
(C99)(C23)
(C23)
(C23)
冪函式
(C99)
(C23)
(C23)

(C99)
(C23)
(C23)
三角函式和雙曲函式
(C23)
(C23)
(C23)
(C23)
(C99)
(C99)
(C99)
最近整數浮點數
(C99)(C99)(C99)
(C99)

(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
浮點數操作
(C99)(C99)
(C99)(C23)
(C99)
窄化操作
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量子與量子指數
十進位制重新編碼函式
總序和載荷函式
分類
(C99)
(C99)
(C99)
(C23)
誤差函式和伽馬函式
(C99)
(C99)
(C99)
(C99)
型別
宏常量
特殊浮點值
(C99)(C23)
引數和返回值
錯誤處理
快速操作指示符
 
定義於標頭檔案 <math.h>
float       log10f( float arg );
(1) (C99 起)
double      log10( double arg );
(2)
long double log10l( long double arg );
(3) (C99 起)
定義於標頭檔案 <tgmath.h>
#define log10( arg )
(4) (C99 起)
1-3) 計算 arg 的常用(以 10 為底)對數。
4) 泛型宏:如果 arg 的型別是 long double,則呼叫 log10l。否則,如果 arg 的型別是整數型別或 double,則呼叫 log10。否則,呼叫 log10f

目錄

[編輯] 引數

arg - 浮點值

[編輯] 返回值

如果未發生錯誤,則返回 arg 的常用(以 10 為底)對數(log10(arg)lg(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。

[編輯] 示例

#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
 
int main(void)
{
    printf("log10(1000) = %f\n", log10(1000));
    printf("log10(0.001) = %f\n", log10(0.001));
    printf("base-5 logarithm of 125 = %f\n", log10(125) / log10(5));
 
    // special values
    printf("log10(1) = %f\n", log10(1));
    printf("log10(+Inf) = %f\n", log10(INFINITY));
 
    // error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("log10(0) = %f\n", log10(0));
    if (errno == ERANGE)
        perror("    errno == ERANGE");
    if (fetestexcept(FE_DIVBYZERO))
        puts("    FE_DIVBYZERO raised");
}

可能的輸出

log10(1000) = 3.000000
log10(0.001) = -3.000000
base-5 logarithm of 125 = 3.000000
log10(1) = 0.000000
log10(+Inf) = inf
log10(0) = -inf
    errno == ERANGE: Numerical result out of range
    FE_DIVBYZERO raised

[編輯] 參考

  • C23 標準 (ISO/IEC 9899:2024)
  • 7.12.6.8 log10 函式(p:待定)
  • 7.25 型別通用數學 <tgmath.h> (p: TBD)
  • F.10.3.8 log10 函式(p:待定)
  • C17 標準 (ISO/IEC 9899:2018)
  • 7.12.6.8 log10 函式(p:179)
  • 7.25 型別通用數學 <tgmath.h> (p: 272-273)
  • F.10.3.8 log10 函式(p:380)
  • C11 標準 (ISO/IEC 9899:2011)
  • 7.12.6.8 log10 函式(p:245)
  • 7.25 型別通用數學 <tgmath.h> (p: 373-375)
  • F.10.3.8 log10 函式(p:522)
  • C99 標準 (ISO/IEC 9899:1999)
  • 7.12.6.8 log10 函式(p:225-226)
  • 7.22 型別通用數學 <tgmath.h> (p: 335-337)
  • F.9.3.8 log10 函式(p:459)
  • C89/C90 標準 (ISO/IEC 9899:1990)
  • 4.5.4.5 log10 函式

[編輯] 另請參閱

(C99)(C99)
計算自然(底數e)對數 (ln(x))
(函式) [編輯]
(C99)(C99)(C99)
計算以2為底的對數 (log2(x))
(函式) [編輯]
(C99)(C99)(C99)
計算1加上給定數的自然(底數e)對數 (ln(1+x))
(函式) [編輯]
C++ 文件 用於 log10