Debian Codegraph @

doc/src/intrinsics/mathematical/asinh.md

raw
1 # asinh(x): Inverse Hyperbolic Arcsine
2
3 Inverse hyperbolic arcsine function.
4
5 ## Declaration
6
7 ### Syntax
8
9 ```fortran
10 retval = asinh(x)
11 elemental real(p) function asinh(x)
12 elemental complex(p) function asinh(x)
13 ```
14 ### Arguments
15
16 `x` the input value, can be real with value greater than or equal to 1 or of
17 type complex.
18
19 ### Return values
20
21 The returned value has the kind of the input value and TYPE may be real
22 or complex.
23
24 ## Description
25
26 **asinh(x)** computes the inverse hyperbolic arcsine function of **x**.
27
28 The result type and kind are the same as input value `x`.
29
30 If the result is complex, the real part is non-negative, and the imaginary part
31 is expressed in radians and lies in the range
32
33 $\frac{-\pi}{2} <= aimag (asinh(x)) <= \frac{\pi}{2}$
34
35 ## Types
36
37 Supported argument types float, double, complex float, complex double.
38
39 ```fortran
40 interface asinh
41 module procedure sasinh, dasinh, casinh, zasinh
42 end interface
43
44 contains
45
46 interface
47 elemental real(sp) function sasinh(x)
48 real(sp), intent(in) :: x
49 end function
50
51 elemental real(dp) function dasinh(x)
52 real(dp), intent(in) :: x
53 end function
54
55 elemental complex(sp) function casinh(x)
56 complex(sp), intent(in) :: x
57 end function
58
59 elemental complex(dp) function zasinh(x)
60 complex(dp), intent(in) :: x
61 end function
62 end interface
63 ```
64 ## Examples
65
66 ```fortran
67 program intrinsics_asinh
68 implicit none
69 print *, asinh(1.0)
70 end program
71 ```
72
73 **Result**:
74
75 ```
76 -0.88137
77 ```
78 ## See Also
79
80 [acosh](acosh.md), [atanh](atanh.md).