命名空间
变体
操作

log10, log10f, log10l

来自 cppreference.cn
< 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