acosh, acoshf, acoshl

float       acoshf( float arg );

double      acosh( double arg );

long double acoshl( long double arg );

#define acosh( arg )

Параметры

Возвращаемое значение

Если ошибки не произошли, возвращается обратная гиперболическая косинус arg (cosh^-1(arg), или arcosh(arg)) на интервале [0, +∞].

Если произошла ошибка области определения, возвращается значение, определённое реализацией (NaN, если поддерживается).

Обработка ошибок

Ошибки сообщаются, как указано в math_errhandling.

Если аргумент меньше 1, возникает ошибка области определения.

Если реализация поддерживает арифметику с плавающей точкой IEEE (IEC 60559),

• если аргумент меньше 1, генерируется FE_INVALID и возвращается NaN
• если аргумент равен 1, возвращается +0
• если аргумент равен +∞, возвращается +∞
• если аргумент равен NaN, возвращается NaN.

Примечания

Хотя стандарт C называет эту функцию "дуга гиперболической косинуса", обратные функции гиперболических функций являются функциями площади. Их аргумент - это площадь гиперболического сектора, а не дуга. Правильное название - "обратная гиперболическая косинус" (используется в POSIX) или "площадь гиперболической косинуса".

Пример

#include <stdio.h>
#include <math.h>
#include <float.h>
#include <errno.h>
#include <fenv.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:2023):
• 7.12.5.1 Функции acosh (p: TBD)
• 7.27 Универсальные математические функции <tgmath.h> (p: TBD)
• F.10.2.1 Функции acosh (p: TBD)
• Стандарт C17 (ISO/IEC 9899:2018):
• 7.12.5.1 Функции acosh (p: 175)
• 7.25 Универсальные математические функции <tgmath.h> (p: 272-273)
• F.10.2.1 Функции acosh (p: 379)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.12.5.1 Функции acosh (p: 240)
• 7.25 Универсальные математические функции <tgmath.h> (p: 373-375)
• F.10.2.1 Функции acosh (p: 520)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.12.5.1 Функции acosh (p: 221)
• 7.22 Универсальные математические функции <tgmath.h> (p: 335-337)
• F.9.2.1 Функции acosh (p: 457)

См. также

Внешние ссылки