Important: The information in this document is obsolete and should not be used for new development.
acosh
You can use theacoshfunction to compute the inverse hyperbolic cosine of a real number.
double_t acosh (double_t x);
x- Any floating-point number in the range 1
x
+
.
DESCRIPTION
Theacoshfunction returns the inverse hyperbolic cosine of its argument. This function is antisymmetric.such that
The
coshfunction performs the inverse operation .EXCEPTIONS
When x is finite and nonzero, the result of might raise one of the following exceptions:
- inexact (for all finite values of x > 1)
- invalid (if x < 1)
SPECIAL CASES
Table 10-30 shows the results when the argument to theacoshfunction is a zero, a NaN, or an Infinity, plus other special cases for theacoshfunction.
Special cases for the acoshfunctionOperation Result Exceptions raised for x < 1 NaN Invalid +0 None NaN Invalid NaN Invalid NaN None[52] + ![]()
None NaN Invalid EXAMPLES
z = acosh(1.0); /* z = +0 */ z = acosh(0.0); /* z = NAN. The invalid exception is raised. */
[52] If the NaN is a signaling NaN, the invalid exception is raised.