xref: /freebsd/lib/msun/man/asin.3 (revision dc36d6f9bb1753f3808552f3afd30eda9a7b206a)
13a8617a8SJordan K. Hubbard.\" Copyright (c) 1991 The Regents of the University of California.
23a8617a8SJordan K. Hubbard.\" All rights reserved.
33a8617a8SJordan K. Hubbard.\"
43a8617a8SJordan K. Hubbard.\" Redistribution and use in source and binary forms, with or without
53a8617a8SJordan K. Hubbard.\" modification, are permitted provided that the following conditions
63a8617a8SJordan K. Hubbard.\" are met:
73a8617a8SJordan K. Hubbard.\" 1. Redistributions of source code must retain the above copyright
83a8617a8SJordan K. Hubbard.\"    notice, this list of conditions and the following disclaimer.
93a8617a8SJordan K. Hubbard.\" 2. Redistributions in binary form must reproduce the above copyright
103a8617a8SJordan K. Hubbard.\"    notice, this list of conditions and the following disclaimer in the
113a8617a8SJordan K. Hubbard.\"    documentation and/or other materials provided with the distribution.
12fbbd9655SWarner Losh.\" 3. Neither the name of the University nor the names of its contributors
133a8617a8SJordan K. Hubbard.\"    may be used to endorse or promote products derived from this software
143a8617a8SJordan K. Hubbard.\"    without specific prior written permission.
153a8617a8SJordan K. Hubbard.\"
163a8617a8SJordan K. Hubbard.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
173a8617a8SJordan K. Hubbard.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
183a8617a8SJordan K. Hubbard.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
193a8617a8SJordan K. Hubbard.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
203a8617a8SJordan K. Hubbard.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
213a8617a8SJordan K. Hubbard.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
223a8617a8SJordan K. Hubbard.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
233a8617a8SJordan K. Hubbard.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
243a8617a8SJordan K. Hubbard.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
253a8617a8SJordan K. Hubbard.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
263a8617a8SJordan K. Hubbard.\" SUCH DAMAGE.
273a8617a8SJordan K. Hubbard.\"
2817303c62SDavid Schultz.Dd July 31, 2008
293a8617a8SJordan K. Hubbard.Dt ASIN 3
303a8617a8SJordan K. Hubbard.Os
313a8617a8SJordan K. Hubbard.Sh NAME
327a15a32aSJordan K. Hubbard.Nm asin ,
3317303c62SDavid Schultz.Nm asinf ,
3417303c62SDavid Schultz.Nm asinl
357a15a32aSJordan K. Hubbard.Nd arc sine functions
3664890443SBruce Evans.Sh LIBRARY
3764890443SBruce Evans.Lb libm
383a8617a8SJordan K. Hubbard.Sh SYNOPSIS
3932eef9aeSRuslan Ermilov.In math.h
403a8617a8SJordan K. Hubbard.Ft double
413a8617a8SJordan K. Hubbard.Fn asin "double x"
427a15a32aSJordan K. Hubbard.Ft float
437a15a32aSJordan K. Hubbard.Fn asinf "float x"
4417303c62SDavid Schultz.Ft long double
4517303c62SDavid Schultz.Fn asinl "long double x"
463a8617a8SJordan K. Hubbard.Sh DESCRIPTION
473a8617a8SJordan K. HubbardThe
4817303c62SDavid Schultz.Fn asin ,
4917303c62SDavid Schultz.Fn asinf ,
5017303c62SDavid Schultzand
5117303c62SDavid Schultz.Fn asinl
527a15a32aSJordan K. Hubbardfunctions compute the principal value of the arc sine of
533a8617a8SJordan K. Hubbard.Fa x .
543a8617a8SJordan K. Hubbard.Sh RETURN VALUES
5517303c62SDavid SchultzThese functions return the arc sine in the range
563a8617a8SJordan K. Hubbard.Bk -words
573a8617a8SJordan K. Hubbard.Bq -\*(Pi/2 , +\*(Pi/2
583a8617a8SJordan K. Hubbard.Ek
593a8617a8SJordan K. Hubbardradians.
608e264694SDavid SchultzIf:
613a8617a8SJordan K. Hubbard.Bd -unfilled -offset indent
62*c5cbef2fSGordon Bergling.Pf \&| Ns Fa x Ns \&| > 1
633a8617a8SJordan K. Hubbard.Ed
643a8617a8SJordan K. Hubbard.Pp
658e264694SDavid Schultz.Fn asin x
668e264694SDavid Schultzraises an invalid exception and returns an \*(Na.
673a8617a8SJordan K. Hubbard.Sh SEE ALSO
683a8617a8SJordan K. Hubbard.Xr acos 3 ,
693a8617a8SJordan K. Hubbard.Xr atan 3 ,
703a8617a8SJordan K. Hubbard.Xr atan2 3 ,
713a8617a8SJordan K. Hubbard.Xr cos 3 ,
723a8617a8SJordan K. Hubbard.Xr cosh 3 ,
738e264694SDavid Schultz.Xr fenv 3 ,
7475141cc9SWolfram Schneider.Xr math 3 ,
753a8617a8SJordan K. Hubbard.Xr sin 3 ,
763a8617a8SJordan K. Hubbard.Xr sinh 3 ,
773a8617a8SJordan K. Hubbard.Xr tan 3 ,
7875141cc9SWolfram Schneider.Xr tanh 3
793a8617a8SJordan K. Hubbard.Sh STANDARDS
803a8617a8SJordan K. HubbardThe
8117303c62SDavid Schultz.Fn asin ,
8217303c62SDavid Schultz.Fn asinf ,
8317303c62SDavid Schultzand
8417303c62SDavid Schultz.Fn asinl
8517303c62SDavid Schultzfunctions conform to
8617303c62SDavid Schultz.St -isoC-99 .
87