1*1c7c1e02Sschwarze.\" $OpenBSD: acosh.3,v 1.18 2021/06/29 14:47:33 schwarze Exp $ 2df930be7Sderaadt.\" Copyright (c) 1991 Regents of the University of California. 3df930be7Sderaadt.\" All rights reserved. 4df930be7Sderaadt.\" 5df930be7Sderaadt.\" Redistribution and use in source and binary forms, with or without 6df930be7Sderaadt.\" modification, are permitted provided that the following conditions 7df930be7Sderaadt.\" are met: 8df930be7Sderaadt.\" 1. Redistributions of source code must retain the above copyright 9df930be7Sderaadt.\" notice, this list of conditions and the following disclaimer. 10df930be7Sderaadt.\" 2. Redistributions in binary form must reproduce the above copyright 11df930be7Sderaadt.\" notice, this list of conditions and the following disclaimer in the 12df930be7Sderaadt.\" documentation and/or other materials provided with the distribution. 136580fee3Smillert.\" 3. Neither the name of the University nor the names of its contributors 14df930be7Sderaadt.\" may be used to endorse or promote products derived from this software 15df930be7Sderaadt.\" without specific prior written permission. 16df930be7Sderaadt.\" 17df930be7Sderaadt.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 18df930be7Sderaadt.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19df930be7Sderaadt.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20df930be7Sderaadt.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 21df930be7Sderaadt.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22df930be7Sderaadt.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23df930be7Sderaadt.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24df930be7Sderaadt.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25df930be7Sderaadt.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26df930be7Sderaadt.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27df930be7Sderaadt.\" SUCH DAMAGE. 28df930be7Sderaadt.\" 29df930be7Sderaadt.\" from: @(#)acosh.3 5.2 (Berkeley) 5/6/91 30df930be7Sderaadt.\" 31*1c7c1e02Sschwarze.Dd $Mdocdate: June 29 2021 $ 32df930be7Sderaadt.Dt ACOSH 3 33f0525d41Stholo.Os 34df930be7Sderaadt.Sh NAME 358a2f5500Sderaadt.Nm acosh , 367ac6a943Smartynas.Nm acoshf , 377ac6a943Smartynas.Nm acoshl 388a2f5500Sderaadt.Nd inverse hyperbolic cosine functions 39df930be7Sderaadt.Sh SYNOPSIS 4086f9d4cdStedu.In math.h 41df930be7Sderaadt.Ft double 42df930be7Sderaadt.Fn acosh "double x" 43df930be7Sderaadt.Ft float 44df930be7Sderaadt.Fn acoshf "float x" 457ac6a943Smartynas.Ft long double 467ac6a943Smartynas.Fn acoshl "long double x" 47df930be7Sderaadt.Sh DESCRIPTION 48df930be7SderaadtThe 49df930be7Sderaadt.Fn acosh 50dfec5a15Sjasonfunction computes the inverse hyperbolic cosine 51df930be7Sderaadtof the real 52df930be7Sderaadtargument 53*1c7c1e02Sschwarze.Fa x . 54dfec5a15SjasonThe 55dfec5a15Sjason.Fn acoshf 56dfec5a15Sjasonfunction is a single precision version of 57dfec5a15Sjason.Fn acosh . 587ac6a943SmartynasThe 597ac6a943Smartynas.Fn acoshl 607ac6a943Smartynasfunction is an extended precision version of 617ac6a943Smartynas.Fn acosh . 62df930be7Sderaadt.Sh RETURN VALUES 63*1c7c1e02SschwarzeIf 64*1c7c1e02Sschwarze.Fa x 65*1c7c1e02Sschwarzeis less than one, 667ac6a943Smartynas.Fn acosh "x" , 67f0525d41Stholo.Fn acoshf "x" 687ac6a943Smartynasand 697ac6a943Smartynas.Fn acoshl "x" 709f1be2b6Stbreturn NaN and set the global variable 71f0525d41Stholo.Va errno 72*1c7c1e02Sschwarzeto 73*1c7c1e02Sschwarze.Er EDOM . 74df930be7Sderaadt.Sh SEE ALSO 75df930be7Sderaadt.Xr asinh 3 , 76df930be7Sderaadt.Xr atanh 3 , 77f1ae3669Sjmc.Xr exp 3 78df930be7Sderaadt.Sh HISTORY 79df930be7SderaadtThe 80df930be7Sderaadt.Fn acosh 81df930be7Sderaadtfunction appeared in 82df930be7Sderaadt.Bx 4.3 . 83