命名空间
变体
操作

acosh, acoshf, acoshl

来自 cppreference.cn
< c‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基本操作
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大值/最小值操作
(C99)
(C99)
指数函数
(C23)
(C99)
(C99)
(C23)
(C23)

(C99)
(C99)(C23)
(C23)
(C23)
幂函数
(C99)
(C23)
(C23)

(C99)
(C23)
(C23)
三角函数和双曲函数
(C23)
(C23)
(C23)
(C23)
(C99)
acosh
(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)
误差函数和伽玛函数
(C99)
(C99)
(C99)
(C99)
类型
宏常量
特殊浮点值
(C99)(C23)
参数和返回值
错误处理
快速操作指示符
 
定义于头文件 <math.h>
float       acoshf( float arg );
(1) (自 C99)
double      acosh( double arg );
(2) (自 C99)
long double acoshl( long double arg );
(3) (自 C99)
定义于头文件 <tgmath.h>
#define acosh( arg )
(4) (自 C99)
1-3) 计算 arg 的反双曲余弦。
4) 类型泛型宏:如果参数类型为 long double,则调用 acoshl。否则,如果参数具有整数类型或类型 double,则调用 acosh。否则,调用 acoshf。如果参数是复数,则宏调用相应的复数函数 (cacoshf, cacosh, cacoshl)。

内容

[编辑] 参数

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

[编辑] 返回值

如果没有错误发生,则返回 arg 的反双曲余弦 (cosh-1
(arg)
,或 arcosh(arg)),其在区间 [0, +∞] 上。

如果发生域错误,则返回实现定义的值(在支持的情况下为 NaN)。

[编辑] 错误处理

错误报告如 math_errhandling 中指定。

如果参数小于 1,则会发生域错误。

如果实现支持 IEEE 浮点算术 (IEC 60559),

  • 如果参数小于 1,则会引发 FE_INVALID 并返回 NaN。
  • 如果参数为 1,则返回 +0。
  • 如果参数为 +∞,则返回 +∞。
  • 如果参数为 NaN,则返回 NaN。

[编辑] 注意

虽然 C 标准将此函数命名为“arc hyperbolic cosine”(反双曲余弦),但双曲函数的反函数是面积函数。它们的参数是双曲扇形的面积,而不是弧长。正确的名称是“inverse hyperbolic cosine”(反双曲余弦)(POSIX 使用)或 “area hyperbolic cosine”(面积双曲余弦)。

[编辑] 示例

#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
 
int main(void)
{
    printf("acosh(1) = %f\nacosh(10) = %f\n", acosh(1), acosh(10));
    printf("acosh(DBL_MAX) = %f\nacosh(Inf) = %f\n", acosh(DBL_MAX), acosh(INFINITY));
 
    // error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("acosh(0.5) = %f\n", acosh(0.5));
    if (errno == EDOM)
        perror("    errno == EDOM");
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID raised");
}

可能的输出

acosh(1) = 0.000000
acosh(10) = 2.993223
acosh(DBL_MAX) = 710.475860
acosh(Inf) = inf
acosh(0.5) = -nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised

[编辑] 参考文献

  • C23 标准 (ISO/IEC 9899:2024)
  • 7.12.5.1 The acosh functions (p: TBD)
  • 7.27 Type-generic math <tgmath.h> (p: TBD)
  • F.10.2.1 The acosh functions (p: TBD)
  • C17 标准 (ISO/IEC 9899:2018)
  • 7.12.5.1 The acosh functions (p: 175)
  • 7.25 Type-generic math <tgmath.h> (p: 272-273)
  • F.10.2.1 The acosh functions (p: 379)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.12.5.1 The acosh functions (p: 240)
  • 7.25 Type-generic math <tgmath.h> (p: 373-375)
  • F.10.2.1 The acosh functions (p: 520)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.12.5.1 The acosh functions (p: 221)
  • 7.22 Type-generic math <tgmath.h> (p: 335-337)
  • F.9.2.1 The acosh functions (p: 457)

[编辑] 参见

(C99)(C99)(C99)
计算反双曲正弦 (arsinh(x))
(函数) [编辑]
(C99)(C99)(C99)
计算反双曲正切 (artanh(x))
(函数) [编辑]
(C99)(C99)
计算双曲余弦 (cosh(x))
(函数) [编辑]
(C99)(C99)(C99)
计算复数反双曲余弦
(函数) [编辑]
C++ 文档 关于 acosh

[编辑] 外部链接

Weisstein, Eric W. "Inverse Hyperbolic Cosine." 来自 MathWorld — Wolfram Web Resource。