tanh, tanhf, tanhl

来自cppreference.com
< c‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基本运算
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大/最小运算
指数函数
(C23)
(C99)
(C99)
(C23)
(C23)
(C99)
(C99)(C23)
(C23)
(C23)
幂函数
(C99)
(C23)
(C23)
(C99)
(C23)
(C23)
三角及双曲函数
(C23)
(C23)
(C23)
(C23)
tanh
(C99)
(C99)
(C99)
误差及伽马函数
(C99)
(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)
类型
宏常量
 
定义于头文件 <math.h>
float       tanhf( float arg );
(1) (C99 起)
double      tanh( double arg );
(2)
long double tanhl( long double arg );
(3) (C99 起)
定义于头文件 <tgmath.h>
#define tanh( arg )
(4) (C99 起)
1-3) 计算 arg 的双曲正切。
4) 泛型宏:若参数拥有 long double 类型,则调用 tanhl 。否则,若参数拥有整数类型或 double 类型,则调用 tanh 。否则调用 tanhf 若参数为复数,则宏调用对应的复数函数( ctanhfctanhctanhl )。

参数

arg - 表示双曲角的浮点值

返回值

若不出现错误,则返回 arg 的双曲正切( tanh(arg)
earg
-e-arg
earg
+e-arg
)。

若发生下溢所致的错误,则返回(舍入后的)正确结果。

错误处理

报告 math_errhandling 中指定的错误。

若实现支持 IEEE 浮点算术( IEC 60559 ),则

  • 若参数为 ±0 ,则返回 ±0
  • 若参数为 ±∞ ,则返回 ±1
  • 若参数为 NaN ,则返回 NaN

注意

POSIX 指定在下溢的情况中,返回不修改的 arg ,而且若不支持这么做,则返回不大于 DBL_MIN 、 FLT_MIN 和 LDBL_MIN 的实现定义值。

示例

#include <stdio.h>
#include <math.h>
 
int main(void)
{
    printf("tanh(1) = %f\ntanh(-1) = %f\n", tanh(1), tanh(-1));
    printf("tanh(0.1)*sinh(0.2)-cosh(0.2) = %f\n", tanh(0.1) * sinh(0.2) - cosh(0.2));
    // 特殊值
    printf("tanh(+0) = %f\ntanh(-0) = %f\n", tanh(0.0), tanh(-0.0));
}

输出:

tanh(1) = 0.761594
tanh(-1) = -0.761594
tanh(0.1)*sinh(0.2)-cosh(0.2) = -1.000000
tanh(+0) = 0.000000
tanh(-0) = -0.000000

引用

  • C11 标准(ISO/IEC 9899:2011):
  • 7.12.5.6 The tanh functions (p: 242)
  • 7.25 Type-generic math <tgmath.h> (p: 373-375)
  • F.10.2.6 The tanh functions (p: 520)
  • C99 标准(ISO/IEC 9899:1999):
  • 7.12.5.6 The tanh functions (p: 222-223)
  • 7.22 Type-generic math <tgmath.h> (p: 335-337)
  • F.9.2.6 The tanh functions (p: 457)
  • C89/C90 标准(ISO/IEC 9899:1990):
  • 4.5.3.3 The tanh function

参阅

(C99)(C99)
计算双曲正弦( sinh(x)
(函数)
(C99)(C99)
计算双曲余弦( cosh(x)
(函数)
(C99)(C99)(C99)
计算反双曲正切( artanh(x)
(函数)
(C99)(C99)(C99)
计算复数双曲正切
(函数)