asinh, asinhf, asinhl

来自cppreference.com
< c‎ | numeric‎ | math
 
C
 
数值
 
常用数学函数
类型
(C99)(C99)    

(C99)(C99)    
(C23)(C23)

函数
基本运算
(C99)
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大/最小运算
(C99)
(C23)
(C23)
(C23)
(C23)    
指数函数
(C23)
(C99)
(C99)
(C23)
(C23)
(C99)
(C99)(C23)
(C23)
(C23)
幂函数
(C99)
(C23)
(C23)
(C99)
(C23)
(C23)
(C23)
三角及双曲函数
(C23)
(C23)
(C23)
(C23)
asinh
(C99)
(C99)
(C99)
误差及伽马函数
(C99)
(C99)
(C99)
(C99)
临近整数的浮点运算
(C99)(C99)(C99)
(C23)
(C99)
(C99)
(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
浮点操作函数
(C99)(C99)
(C99)(C23)
(C99)
窄化运算
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量与量指数函数
十进制重编码函数
全序与载荷函数
分类
(C99)
(C23)
(C99)
(C99)
(C99)
(C99)
(C99)
(C23)
(C23)
宏常量
特殊浮点值
(C99)(C23)
(C99)(C23)
参数与返回值
(C23)(C23)
(C99)(C99)(C99)(C99)(C99)    
错误处理
(C99)    

 
在标头 <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 标准命名此函数为“弧双曲正弦”，但双曲函数的反函数仍是面积函数。其实参为双曲扇形的面积，而非弧长。正确的名称是“反双曲正弦”（ POSIX 所用）或“面积双曲正弦”。

示例

运行此代码
#include <math.h>
#include <stdio.h>
 
int main(void)
{
    printf("asinh(1) = %f\nasinh(-1) = %f\n", asinh(1), asinh(-1));
    // 特殊值
    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 （第 240-241 页）
  • 7.25 Type-generic math <tgmath.h> （第 373-375 页）
  • F.10.2.2 The asinh functions （第 520 页）
  • C17 标准（ISO/IEC 9899:2018）：
  • 7.12.5.2 The asinh functions （第 240-241 页）
  • 7.25 Type-generic math <tgmath.h> （第 373-375 页）
  • F.10.2.2 The asinh functions （第 520 页）
  • C11 标准（ISO/IEC 9899:2011）：
  • 7.12.5.2 The asinh functions （第 240-241 页）
  • 7.25 Type-generic math <tgmath.h> （第 373-375 页）
  • F.10.2.2 The asinh functions （第 520 页）
  • C99 标准（ISO/IEC 9899:1999）：
  • 7.12.5.2 The asinh functions （第 221 页）
  • 7.22 Type-generic math <tgmath.h> （第 335-337 页）
  • F.9.2.2 The asinh functions （第 457 页）

参阅

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

外部链接

Weisstein, Eric W. “反双曲正弦”来自 MathWorld--A Wolfram Web Resource 。
来自“https://zh.cppreference.com/mwiki/index.php?title=c/numeric/math/asinh&oldid=91406”