xref: /openbsd-src/lib/libm/man/cosh.3 (revision 1c7c1e02dc27bdb87a106695fcd64d107e077f53)
1*1c7c1e02Sschwarze.\"	$OpenBSD: cosh.3,v 1.17 2021/06/29 14:47:33 schwarze Exp $
2df930be7Sderaadt.\" Copyright (c) 1989, 1991 The 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: @(#)cosh.3	5.1 (Berkeley) 5/2/91
30df930be7Sderaadt.\"
31*1c7c1e02Sschwarze.Dd $Mdocdate: June 29 2021 $
32df930be7Sderaadt.Dt COSH 3
33df930be7Sderaadt.Os
34df930be7Sderaadt.Sh NAME
358a2f5500Sderaadt.Nm cosh ,
367ac6a943Smartynas.Nm coshf ,
377ac6a943Smartynas.Nm coshl
388a2f5500Sderaadt.Nd hyperbolic cosine functions
39df930be7Sderaadt.Sh SYNOPSIS
4086f9d4cdStedu.In math.h
41df930be7Sderaadt.Ft double
42df930be7Sderaadt.Fn cosh "double x"
43df930be7Sderaadt.Ft float
44df930be7Sderaadt.Fn coshf "float x"
457ac6a943Smartynas.Ft long double
467ac6a943Smartynas.Fn coshl "long double x"
47df930be7Sderaadt.Sh DESCRIPTION
48df930be7SderaadtThe
49df930be7Sderaadt.Fn cosh
50dfec5a15Sjasonfunction computes the hyperbolic cosine of
51df930be7Sderaadt.Fa x .
52dfec5a15SjasonThe
53dfec5a15Sjason.Fn coshf
54dfec5a15Sjasonfunction is a single precision version of
55dfec5a15Sjason.Fn cosh .
567ac6a943SmartynasThe
577ac6a943Smartynas.Fn coshl
587ac6a943Smartynasfunction is an extended precision version of
597ac6a943Smartynas.Fn cosh .
60df930be7Sderaadt.Sh RETURN VALUES
61f0525d41StholoIf the magnitude of x is too large,
627ac6a943Smartynas.Fn cosh "x" ,
63f0525d41Stholo.Fn coshf "x"
647ac6a943Smartynasand
657ac6a943Smartynas.Fn coshl "x"
669f1be2b6Stbreturn infinity and set the global variable
67f0525d41Stholo.Va errno
68*1c7c1e02Sschwarzeto
69*1c7c1e02Sschwarze.Er ERANGE .
70df930be7Sderaadt.Sh SEE ALSO
71df930be7Sderaadt.Xr acos 3 ,
72df930be7Sderaadt.Xr asin 3 ,
73df930be7Sderaadt.Xr atan 3 ,
74df930be7Sderaadt.Xr atan2 3 ,
75df930be7Sderaadt.Xr cos 3 ,
76df930be7Sderaadt.Xr sin 3 ,
77df930be7Sderaadt.Xr sinh 3 ,
78df930be7Sderaadt.Xr tan 3 ,
79350bb3b8Salex.Xr tanh 3
8023fbb714Sschwarze.Sh HISTORY
8123fbb714SschwarzeThe
8223fbb714Sschwarze.Fn cosh
8323fbb714Sschwarzefunction first appeared in
8423fbb714Sschwarze.At v7 .
85