std::asinh, std::asinhf, std::asinhl
Определено в заголовочном файле <cmath> | ||
|---|---|---|
float asinh ( float num ); double asinh ( double num ); long double asinh ( long double num ); | (1) | (до 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) |
| Дополнительные перегрузки (начиная с C++11) | ||
Определено в заголовочном файле <cmath> | ||
template< class Integer > double asinh ( Integer num ); | (A) | (constexpr начиная с C++26) |
num. Библиотека предоставляет перегрузки std::asinh для всех не cv-квалифицированных типов с плавающей точкой в качестве типа параметра.(начиная с C++23)
S) Перегрузка SIMD выполняет поэлементное std::asinh над v_num. (Определения приведены в разделах math-floating-point и deduced-simd-t.) | (начиная с C++26) |
| A) Предоставляются дополнительные перегрузки для всех целочисленных типов, которые рассматриваются как double. | (начиная с C++11) |
Параметры
| num | - | значение с плавающей точкой или целочисленное значение |
Возвращаемое значение
Если ошибки не возникают, возвращается обратный гиперболический синус от num (sinh-1(num), или arsinh(num)).
Если возникает ошибка диапазона из-за потери значимости, возвращается правильный результат (после округления).
Обработка ошибок
Об ошибках сообщается в соответствии с 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) | вычисляет обратный гиперболический косинус (\({\small\operatorname{arcosh}{x}}\)arcosh(x)) (функция) |
|
(C++11)(C++11)(C++11) | вычисляет обратный гиперболический тангенс (\({\small\operatorname{artanh}{x}}\)artanh(x)) (функция) |
|
(C++11)(C++11) | вычисляет гиперболический синус (\({\small\sinh{x}}\)sinh(x)) (функция) |
|
(C++11) | вычисляет площадной гиперболический синус комплексного числа (\({\small\operatorname{arsinh}{z}}\)arsinh(z)) (шаблон функции) |
Документация C для asinh |
|
Внешние ссылки
| Вайсштейн, Эрик У. «Обратный гиперболический синус». Из MathWorld — веб-ресурса Wolfram. |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/numeric/math/asinh
