log10, log10f, log10l

来自cppreference.com
< c‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基本运算
(C99)
(C99)
(C99)
(C99)
(C99)
(C99)(C99)(C99)
指数函数
(C99)
(C99)
log10
(C99)
(C99)
幂函数
(C99)
(C99)
三角及双曲函数
(C99)
(C99)
(C99)
误差及伽马函数
(C99)
(C99)
(C99)
(C99)
临近整数的浮点运算
(C99)(C99)(C99)
(C99)
(C99)(C99)(C99)
浮点数操作函数
(C99)(C99)
(C99)
(C99)
分类
(C99)
(C99)
(C99)
类型
(C99)(C99)
宏常量
 
定义于头文件 <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 )对数( log
10
(arg)
lg(arg) )。

若出现定义域错误,则返回实现定义值(支持的平台上为 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 <stdio.h>
#include <math.h>
#include <float.h>
#include <errno.h>
#include <fenv.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));
    // 特殊值
    printf("log10(1) = %f\n", log10(1));
    printf("log10(+Inf) = %f\n", log10(INFINITY));
    // 错误处理
    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

引用

  • C11 standard (ISO/IEC 9899:2011):
  • 7.12.6.8 The log10 functions (p: 245)
  • 7.25 Type-generic math <tgmath.h> (p: 373-375)
  • F.10.3.8 The log10 functions (p: 522)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.12.6.8 The log10 functions (p: 225-226)
  • 7.22 Type-generic math <tgmath.h> (p: 335-337)
  • F.9.3.8 The log10 functions (p: 459)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.5.4.5 The log10 function

参阅

(C99)(C99)
计算自然对数(底为e) (ln(x)
(函数)
(C99)(C99)(C99)
计算底为2的对数 (log2(x)
(函数)
(C99)(C99)(C99)
计算给定数加1的自然对数(底为e)(ln(1+x)
(函数)