Namespaces
Variants

acosh, acoshf, acoshl

From cppreference.net
< c ‎ | numeric ‎ | math
Common mathematical functions
Functions
Basic operations
(C99)
(C99)
(C99)
(C99) (C99) (C99) (C23)
Maximum/minimum operations
Exponential functions
Power functions
Trigonometric and hyperbolic functions
Nearest integer floating-point
(C99) (C99) (C99)
(C23) (C23) (C23) (C23)
Floating-point manipulation
Narrowing operations
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
Quantum and quantum exponent
Decimal re-encoding functions
Total order and payload functions
Classification
Error and gamma functions
(C99)
(C99)
(C99)
(C99)
Types
Macro constants
Special floating-point values
Arguments and return values
Error handling
Fast operation indicators
Определено в заголовке <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 называет эту функцию «аркгиперболический косинус», обратными функциями гиперболических функций являются ареа-функции. Их аргумент представляет собой площадь гиперболического сектора, а не дугу. Корректное название — «обратный гиперболический косинус» (используется в POSIX) или «ареа-гиперболический косинус».

Пример

#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));
    // обработка ошибок
    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 Функции acosh (стр.: TBD)
  • 7.27 Обобщённая математика <tgmath.h> (стр.: TBD)
  • F.10.2.1 Функции acosh (стр.: TBD)
  • Стандарт C17 (ISO/IEC 9899:2018):
  • 7.12.5.1 Функции acosh (стр. 175)
  • 7.25 Обобщённая математика <tgmath.h> (стр. 272-273)
  • F.10.2.1 Функции acosh (стр. 379)
  • Стандарт C11 (ISO/IEC 9899:2011):
  • 7.12.5.1 Функции acosh (стр. 240)
  • 7.25 Обобщённая математика <tgmath.h> (стр. 373-375)
  • F.10.2.1 Функции acosh (стр. 520)
  • Стандарт C99 (ISO/IEC 9899:1999):
  • 7.12.5.1 Функции acosh (стр. 221)
  • 7.22 Обобщённая математика <tgmath.h> (стр. 335-337)
  • F.9.2.1 Функции acosh (стр. 457)

Смотрите также

(C99) (C99) (C99)
вычисляет обратный гиперболический синус ( arsinh(x) )
(функция)
(C99) (C99) (C99)
вычисляет обратный гиперболический тангенс ( artanh(x) )
(функция)
(C99) (C99)
вычисляет гиперболический косинус ( cosh(x) )
(функция)
(C99) (C99) (C99)
вычисляет комплексный гиперболический арккосинус
(функция)
C++ documentation для acosh

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

Вайсштейн, Эрик В. "Обратный гиперболический косинус." Из MathWorld — веб-ресурс Wolfram.