Namespaces
Variants

std:: asinh, std:: asinhf, std:: asinhl

From cppreference.net
C++
Numerics library
Common mathematical functions
Nearest integer floating point operations
(C++11)
(C++11)
(C++11) (C++11) (C++11)
Floating point manipulation functions
(C++11) (C++11)
(C++11)
(C++11)
Classification and comparison
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Types
(C++11)
(C++11)
(C++11)
Macro constants
Определено в заголовочном файле <cmath>
(1)
float asinh ( float num ) ;

double asinh ( double num ) ;

long double asinh ( long double num ) ;
(до C++23)
/*floating-point-type*/
asinh ( /*floating-point-type*/ num ) ;
(начиная с C++23)
(constexpr начиная с C++26)
float asinhf ( float num ) ;
(2) (начиная с C++11)
(constexpr начиная с C++26)
long double asinhl ( long double num ) ;
(3) (начиная с C++11)
(constexpr начиная с C++26)
SIMD перегрузка (начиная с C++26)
Определено в заголовочном файле <simd>
template < /*math-floating-point*/ V >

constexpr /*deduced-simd-t*/ < V >

asinh ( const V & v_num ) ;
(S) (начиная с C++26)
Определено в заголовочном файле <cmath>
template < class Integer >
double asinh ( Integer num ) ;
(A) (constexpr начиная с C++26)
1-3) Вычисляет обратный гиперболический синус от num . Библиотека предоставляет перегрузки std::asinh для всех неквалифицированных cv типов с плавающей запятой в качестве типа параметра. (начиная с C++23)
S) Перегрузка SIMD выполняет поэлементное вычисление std::asinh для v_num .
(См. math-floating-point и deduced-simd-t для их определений.)
(since C++26)
A) Дополнительные перегрузки предоставляются для всех целочисленных типов, которые трактуются как double .
(since C++11)

Содержание

Параметры

num - значение с плавающей точкой или целочисленное значение

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

Если ошибок не возникает, возвращается обратный гиперболический синус num ( sinh -1
(num) , или arsinh(num) ).

Если происходит ошибка диапазона из-за потери значимости (underflow), возвращается корректный результат (после округления).

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

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

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

  • если аргумент равен ±0 или ±∞, он возвращается без изменений.
  • если аргумент равен NaN, возвращается NaN.

Примечания

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

Дополнительные перегрузки не обязаны быть предоставлены в точности как (A) . Они лишь должны быть достаточными для обеспечения того, чтобы для их аргумента num целочисленного типа std :: asinh ( num ) имел тот же эффект, что и std :: asinh ( static_cast < double > ( num ) ) .

Примеры

Запустить этот код 
#include <cmath>
#include <iostream>
int main()
{
    std::cout << "asinh(1) = " << std::asinh(1) << '\n'
              << "asinh(-1) = " << std::asinh(-1) << '\n';
    // special values
    std::cout << "asinh(+0) = " << std::asinh(+0.0) << '\n'
              << "asinh(-0) = " <<  std::asinh(-0.0) << '\n';
}

Вывод: 

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

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

(C++11) (C++11) (C++11)
вычисляет обратный гиперболический косинус ( arcosh(x) )
(функция)
(C++11) (C++11) (C++11)
вычисляет обратный гиперболический тангенс ( artanh(x) )
(функция)
(C++11) (C++11)
вычисляет гиперболический синус ( sinh(x) )
(функция)
(C++11)
вычисляет площадь гиперболического синуса комплексного числа ( arsinh(z) )
(шаблон функции)
Документация C для asinh

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

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