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

From cppreference.com

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros(C++20)
Language support library
Concepts library(C++20)
Diagnostics library
Memory management library
Metaprogramming library(C++11)
General utilities library
Containers library
Iterators library
Ranges library(C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library(C++17)
Concurrency support library(C++11)
Execution control library(C++26)
Technical specifications
Symbols index
External libraries

[edit]

Numerics library

Common mathematical functions

Mathematical special functions(C++17)

Mathematical constants(C++20)

Basic linear algebra algorithms(C++26)

Data-parallel types (SIMD)(C++26)

Floating-point environment(C++11)

Complex numbers

Numeric array (valarray)

Pseudo-random number generation

Bit manipulation(C++20)

Saturation arithmetic(C++26)

(C++17)

(C++17)

(C++20)

(C++20)

Generic numeric operations

iota (C++11)
ranges::iota (C++23)
accumulate
inner_product
adjacent_difference
partial_sum

reduce (C++17)
transform_reduce (C++17)
inclusive_scan (C++17)
exclusive_scan (C++17)
transform_inclusive_scan (C++17)
transform_exclusive_scan (C++17)

C-style checked integer arithmetic

ckd_add (C++26)
ckd_sub (C++26)

ckd_mul (C++26)

[edit]

Common mathematical functions

Functions

Basic operations

abs(int)labsllabsimaxabs (C++11)
abs(float)fabs
divldivlldivimaxdiv (C++11)

fmod
remainder (C++11)
remquo (C++11)
fma (C++11)
fmax (C++11)
fmin (C++11)
fdim (C++11)
nannanfnanl (C++11)(C++11)(C++11)

Exponential functions

exp
exp2 (C++11)
expm1 (C++11)

log
log10
log1p (C++11)
log2 (C++11)

Power functions

sqrt
cbrt (C++11)

hypot (C++11)
pow

Trigonometric and
hyperbolic functions

sin
cos
tan
asin
acos
atan
atan2

sinh
cosh
tanh
asinh (C++11)
acosh (C++11)
atanh (C++11)

Error and gamma functions

erf (C++11)
erfc (C++11)

lgamma (C++11)
tgamma (C++11)

Nearest integer floating point operations

ceil
floor
roundlroundllround (C++11)(C++11)(C++11)

trunc (C++11)
nearbyint (C++11)
rintlrintllrint (C++11)(C++11)(C++11)

Floating point manipulation functions

ldexp
scalbnscalbln (C++11)(C++11)
ilogb (C++11)
logb (C++11)

frexp
modf
nextafternexttoward (C++11)(C++11)
copysign (C++11)

Classification and comparison

fpclassify (C++11)
isfinite (C++11)
isinf (C++11)
isnan (C++11)
isnormal (C++11)
signbit (C++11)

isgreater (C++11)
isgreaterequal (C++11)
isless (C++11)
islessequal (C++11)
islessgreater (C++11)
isunordered (C++11)

Types

div_t
ldiv_t
lldiv_t (C++11)

imaxdiv_t (C++11)
float_t (C++11)
double_t (C++11)

Macro constants

HUGE_VALFHUGE_VALHUGE_VALL (C++11)(C++11)
math_errhandlingMATH_ERRNOMATH_ERREXCEPT (C++11)
INFINITY (C++11)
NAN (C++11)

Classification
FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C++11)(C++11)(C++11)(C++11)(C++11)

[edit]

Defined in header`<cmath>`
	(1)
float asinh(float num); double asinh(double num); longdouble asinh(longdouble num);			(until C++23)
/floating-point-type/ asinh(/floating-point-type/ num);			(since C++23) (constexpr since C++26)
float asinhf(float num);		(2)	(since C++11) (constexpr since C++26)
longdouble asinhl(longdouble num);		(3)	(since C++11) (constexpr since C++26)
SIMD overload(since C++26)
Defined in header`<simd>`
template</math-floating-point/ V> constexpr/deduced-simd-t/<V> asinh(const V& v_num);		(S)	(since C++26)
Additional overloads(since C++11)
Defined in header`<cmath>`
template<class Integer> double asinh( Integer num);		(A)	(constexpr since C++26)

1-3) Computes the inverse hyperbolic sine ofnum. The library provides overloads ofstd::asinh for all cv-unqualified floating-point types as the type of the parameter.(since C++23)

S) The SIMD overload performs an element-wisestd::asinh onv_num.

(Seemath-floating-point anddeduced-simd-t for their definitions.)

(since C++26)

A) Additional overloads are provided for all integer types, which are treated asdouble.

(since C++11)

[edit]Parameters

num

floating-point or integer value

[edit]Return value

If no errors occur, the inverse hyperbolic sine ofnum (sinh-1
(num), orarsinh(num)), is returned.

If a range error occurs due to underflow, the correct result (after rounding) is returned.

[edit]Error handling

Errors are reported as specified inmath_errhandling.

If the implementation supports IEEE floating-point arithmetic (IEC 60559),

if the argument is ±0 or ±∞, it is returned unmodified.
if the argument is NaN, NaN is returned.

[edit]Notes

Although the C standard (to which C++ refers for this function) names this function "arc hyperbolic sine", the inverse functions of the hyperbolic functions are the area functions. Their argument is the area of a hyperbolic sector, not an arc. The correct name is "inverse hyperbolic sine" (used by POSIX) or "area hyperbolic sine".

The additional overloads are not required to be provided exactly as(A). They only need to be sufficient to ensure that for their argumentnum of integer type,std::asinh(num) has the same effect asstd::asinh(static_cast<double>(num)).

[edit]Examples

Run this code

#include <cmath>#include <iostream> int main(){std::cout<<"asinh(1) = "<< std::asinh(1)<<'\n'<<"asinh(-1) = "<< std::asinh(-1)<<'\n'; // special valuesstd::cout<<"asinh(+0) = "<< std::asinh(+0.0)<<'\n'<<"asinh(-0) = "<<  std::asinh(-0.0)<<'\n';}

Output:

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

[edit]See also

acoshacoshfacoshl (C++11)(C++11)(C++11)	computes the inverse hyperbolic cosine (\({\small\operatorname{arcosh}{x}}\)arcosh(x)) (function)[edit]
atanhatanhfatanhl (C++11)(C++11)(C++11)	computes the inverse hyperbolic tangent (\({\small\operatorname{artanh}{x}}\)artanh(x)) (function)[edit]
sinhsinhfsinhl (C++11)(C++11)	computes hyperbolic sine (\({\small\sinh{x}}\)sinh(x)) (function)[edit]
asinh(std::complex) (C++11)	computes area hyperbolic sine of a complex number (\({\small\operatorname{arsinh}{z}}\)arsinh(z)) (function template)[edit]
C documentation forasinh