tanh, tanhf, tanhl

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

数值

常用数学函数

浮点环境

复数算术

伪随机数生成

泛型数学

 

常用数学函数

函数
基本运算
abslabsllabsimaxabs (C99) fabs divldivlldivimaxdiv (C99) fmod	remainder (C99) remquo (C99) fma (C99) fmax (C99) fmin (C99) fdim (C99) nannanfnanl (C99)(C99)(C99)
指数函数
exp exp2 (C99) expm1 (C99)	log log10 log1p (C99) log2 (C99)
幂函数
sqrt cbrt (C99)	hypot (C99) pow
三角及双曲函数
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)
误差及伽马函数
erf (C99) erfc (C99)	lgamma (C99) tgamma (C99)
临近整数的浮点运算
ceil floor roundlroundllround (C99)(C99)(C99)	trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99)
浮点数操作函数
ldexp scalbnscalbln (C99)(C99) ilogb (C99) logb (C99)	frexp modf nextafternexttoward (C99)(C99) copysign (C99)
分类
fpclassify (C99) isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99)	isgreater (C99) isgreaterequal (C99) isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99)
类型
div_tldiv_tlldiv_timaxdiv_t (C99)(C99)	float_tdouble_t (C99)(C99)
宏常量
HUGE_VALFHUGE_VALHUGE_VALL (C99)(C99) FP_FAST_FMAFFP_FAST_FMAFP_FAST_FMAL (C99)(C99)(C99) math_errhandlingMATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)(C99)	INFINITY (C99) NAN (C99) FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99)

 

定义于头文件 <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 若参数为复数，则宏调用对应的复数函数（ ctanhf 、 ctanh 、 ctanhl ）。

参数

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 standard (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 standard (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 standard (ISO/IEC 9899:1990):

• 4.5.3.3 The tanh function

参阅

sinhsinhfsinhl (C99)(C99)	计算双曲正弦 （sh(x)） (函数)
coshcoshfcoshl (C99)(C99)	计算双曲余弦 （ch(x)） (函数)
atanhatanhfatanhl (C99)(C99)(C99)	计算反双曲正切 （artanh(x)） (函数)
ctanhctanhfctanhl (C99)(C99)(C99)	计算复数双曲正切 (函数)