asinh, asinhf, asinhl

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

数值

常用数学函数

浮点环境 (C99)

伪随机数生成

复数运算 (C99)

类型通用数学 (C99)

位操作 (C23)

检查整数运算 (C23)

 

常用数学函数

函数 基本操作 abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) 最大值/最小值操作 fmax (C99) fmin (C99) fmaximum (C23) fminimum (C23) fmaximum_mag (C23)  fmaximum_num (C23) fminimum_mag (C23) fminimum_num (C23) fmaximum_mag_num (C23) fminimum_mag_num (C23)   指数函数 exp exp10 (C23) exp2 (C99) expm1 (C99) exp10m1 (C23) exp2m1 (C23) log log10 log2 (C99) log1plogp1 (C99)(C23) log10p1 (C23) log2p1 (C23) 幂函数 sqrt cbrt (C99) rootn (C23) rsqrt (C23) hypot (C99) compound (C23) pow pown (C23) powr (C23) 三角函数和双曲函数 sin cos tan asin acos atan atan2 sinpi (C23) cospi (C23) tanpi (C23) asinpi (C23) acospi (C23) atanpi (C23) atan2pi (C23) sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)

最近整数浮点数 ceil floor roundlroundllround (C99)(C99)(C99) roundeven (C23) trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99) fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23) 浮点数操作 ldexp frexp scalbnscalbln (C99)(C99) ilogbllogb (C99)(C23) logb (C99) modf nextafternexttoward (C99)(C99) nextupnextdown (C23)(C23) copysign (C99) canonicalize (C23) 窄化操作 fadd (C23) fsub (C23) fmul (C23) fdiv (C23) ffma (C23) fsqrt (C23) 量子与量子指数 quantizedN (C23) quantumdN (C23) samequantumdN (C23) llquantexpdN (C23) 十进制重新编码函数 encodedecdN (C23) decodedecdN (C23) encodebindN (C23) decodebindN (C23) 总序和载荷函数 totalorder (C23) getpayload (C23) setpayload (C23) setpayloadsig (C23) 分类 fpclassify (C99) iscanonical (C23)  isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99) issubnormal (C23) iszero (C23) isgreater (C99) isgreaterequal (C99)   isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99) issignaling (C23) iseqsig (C23)

误差函数和伽马函数 erf (C99) erfc (C99) lgamma (C99) tgamma (C99) 类型 div_tldiv_tlldiv_timaxdiv_t (C99)(C99) float_tdouble_t (C99)(C99) _Decimal32_t_Decimal64_t (C23)(C23) 宏常量 特殊浮点值 HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) 参数和返回值 FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99) FP_LLOGB0FP_LLOGBNAN (C23)(C23) FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23) 错误处理 MATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)  math_errhandling (C99) 快速操作指示符 FP_FAST_FMAFFP_FAST_FMA (C99)(C99) FP_FAST_FADDFP_FAST_FADDLFP_FAST_DADDLFP_FAST_DMADDDN (C23)(C23)(C23)(C23) FP_FAST_FMULFP_FAST_FMULLFP_FAST_DMULLFP_FAST_DMMULDN (C23)(C23)(C23)(C23) FP_FAST_FFMAFP_FAST_FFMALFP_FAST_DFMALFP_FAST_DMFMADN (C23)(C23)(C23)(C23) FP_FAST_FMALFP_FAST_FMADN (C99)(C23) FP_FAST_FSUBFP_FAST_FSUBLFP_FAST_DSUBLFP_FAST_DMSUBDN (C23)(C23)(C23)(C23) FP_FAST_FDIVFP_FAST_FDIVLFP_FAST_DDIVLFP_FAST_DMDIVDN (C23)(C23)(C23)(C23) FP_FAST_FSQRTFP_FAST_FSQRTLFP_FAST_DSQRTLFP_FAST_DMSQRTDN (C23)(C23)(C23)(C23)

 

定义于头文件 <math.h>
float       asinhf( float arg );	(1)	(C99 起)
double      asinh( double arg );	(2)	(C99 起)
long double asinhl( long double arg );	(3)	(C99 起)
定义于头文件 <tgmath.h>
#define asinh( arg )	(4)	(C99 起)

1-3) 计算 arg 的反双曲正弦。

4) 类型泛型宏：如果参数类型为 long double，则调用 asinhl。否则，如果参数为整数类型或类型为 double，则调用 asinh。否则，调用 asinhf。如果参数为复数，则宏调用相应的复数函数 (casinhf, casinh, casinhl)。

参数

arg

-

表示双曲扇形面积的浮点值

返回值

如果没有错误发生，则返回 arg 的反双曲正弦（sinh-1
(arg)，或 arsinh(arg)）。

如果因下溢发生范围错误，则返回正确结果（舍入后）。

错误处理

错误按 math_errhandling 中指定的方式报告。

如果实现支持 IEEE 浮点运算 (IEC 60559)，

• 如果参数为 ±0 或 ±∞，则原样返回。
• 如果参数为 NaN，则返回 NaN。

注意

尽管 C 标准将此函数命名为“反双曲正弦”（"arc hyperbolic sine"），但双曲函数的反函数是面积函数。它们的参数是双曲扇形的面积，而不是弧。正确的名称是“反双曲正弦”（POSIX 使用）或“面积双曲正弦”。

示例

运行此代码

#include <math.h>
#include <stdio.h>
 
int main(void)
{
    printf("asinh(1) = %f\nasinh(-1) = %f\n", asinh(1), asinh(-1));
    // special values
    printf("asinh(+0) = %f\nasinh(-0) = %f\n", asinh(0.0), asinh(-0.0));
}

输出

asinh(1) = 0.881374
asinh(-1) = -0.881374
asinh(+0) = 0.000000
asinh(-0) = -0.000000

参考文献

• C23 标准 (ISO/IEC 9899:2024)

• 7.12.5.2 The asinh functions (p: 240-241)

• 7.25 类型通用数学 <tgmath.h> (p: 373-375)

• F.10.2.2 The asinh functions (p: 520)

• C17 标准 (ISO/IEC 9899:2018)

• 7.12.5.2 The asinh functions (p: 240-241)

• 7.25 类型通用数学 <tgmath.h> (p: 373-375)

• F.10.2.2 The asinh functions (p: 520)

• C11 标准 (ISO/IEC 9899:2011)

• 7.12.5.2 The asinh functions (p: 240-241)

• 7.25 类型通用数学 <tgmath.h> (p: 373-375)

• F.10.2.2 The asinh functions (p: 520)

• C99 标准 (ISO/IEC 9899:1999)

• 7.12.5.2 The asinh functions (p: 221)

• 7.22 类型通用数学 <tgmath.h> (p: 335-337)

• F.9.2.2 The asinh functions (p: 457)

另请参阅

acoshacoshfacoshl (C99)(C99)(C99)	计算反双曲余弦 (\({\small\operatorname{arcosh}{x} }\)arcosh(x)) (函数)
atanhatanhfatanhl (C99)(C99)(C99)	计算反双曲正切 (\({\small\operatorname{artanh}{x} }\)artanh(x)) (函数)
sinhsinhfsinhl (C99)(C99)	计算双曲正弦 (\({\small\sinh{x} }\)sinh(x)) (函数)
casinhcasinhfcasinhl (C99)(C99)(C99)	计算复反双曲正弦 (函数)
C++ 文档 for asinh

外部链接

Weisstein, Eric W. "Inverse Hyperbolic Sine." From MathWorld — A Wolfram Web Resource.