161f28255Scgd.\" Copyright (c) 1991 The Regents of the University of California. 261f28255Scgd.\" All rights reserved. 361f28255Scgd.\" 461f28255Scgd.\" Redistribution and use in source and binary forms, with or without 561f28255Scgd.\" modification, are permitted provided that the following conditions 661f28255Scgd.\" are met: 761f28255Scgd.\" 1. Redistributions of source code must retain the above copyright 861f28255Scgd.\" notice, this list of conditions and the following disclaimer. 961f28255Scgd.\" 2. Redistributions in binary form must reproduce the above copyright 1061f28255Scgd.\" notice, this list of conditions and the following disclaimer in the 1161f28255Scgd.\" documentation and/or other materials provided with the distribution. 12eb7c1594Sagc.\" 3. Neither the name of the University nor the names of its contributors 1361f28255Scgd.\" may be used to endorse or promote products derived from this software 1461f28255Scgd.\" without specific prior written permission. 1561f28255Scgd.\" 1661f28255Scgd.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 1761f28255Scgd.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 1861f28255Scgd.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 1961f28255Scgd.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 2061f28255Scgd.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 2161f28255Scgd.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 2261f28255Scgd.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 2361f28255Scgd.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 2461f28255Scgd.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 2561f28255Scgd.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 2661f28255Scgd.\" SUCH DAMAGE. 2761f28255Scgd.\" 28dfb9caabSmycroft.\" from: @(#)asin.3 5.1 (Berkeley) 5/2/91 29*56b14ee0Swiz.\" $NetBSD: asin.3,v 1.18 2017/07/03 21:32:50 wiz Exp $ 3061f28255Scgd.\" 317550e81bSmatt.Dd January 29, 2013 3261f28255Scgd.Dt ASIN 3 3361f28255Scgd.Os 3461f28255Scgd.Sh NAME 35f8173630Skleink.Nm asin , 367550e81bSmatt.Nm asinf , 377550e81bSmatt.Nm asinl 38df8b005fSjtc.Nd arc sine function 39312aca53Sperry.Sh LIBRARY 40312aca53Sperry.Lb libm 4161f28255Scgd.Sh SYNOPSIS 42472351e1Swiz.In math.h 4361f28255Scgd.Ft double 4461f28255Scgd.Fn asin "double x" 45fd8d17a5Sjtc.Ft float 46fd8d17a5Sjtc.Fn asinf "float x" 477550e81bSmatt.Ft long double 487550e81bSmatt.Fn asinl "long double x" 4961f28255Scgd.Sh DESCRIPTION 5061f28255ScgdThe 517550e81bSmatt.Fn asin , 527550e81bSmatt.Fn asinf , 53fd8d17a5Sjtcand 547550e81bSmatt.Fn asinl 55fd8d17a5Sjtcfunctions compute the principal value of the arc sine of 56df8b005fSjtc.Fa x 57df8b005fSjtcin the range 5861f28255Scgd.Bk -words 59df8b005fSjtc.Bq -\*(Pi/2, +\*(Pi/2 . 6061f28255Scgd.Ek 61df8b005fSjtc.Sh RETURN VALUES 62af726e9cSchristos.\" POSIX_MODE 63*56b14ee0SwizIf |x|>1, 647550e81bSmatt.Fn asin "x" , 657550e81bSmatt.Fn asinf "x" , 66af726e9cSchristosand 677550e81bSmatt.Fn asinl "x" 68af726e9cSchristosreturn NaN and set the global variable 69af726e9cSchristos.Va errno 70af726e9cSchristosto EDOM. 71af726e9cSchristos.\" SYSV_MODE 72af726e9cSchristos.\" call 73af726e9cSchristos.\" .Xr matherr 3 . 7461f28255Scgd.Sh SEE ALSO 7561f28255Scgd.Xr acos 3 , 7661f28255Scgd.Xr atan 3 , 7761f28255Scgd.Xr atan2 3 , 7861f28255Scgd.Xr cos 3 , 7961f28255Scgd.Xr cosh 3 , 80306d24c5Swiz.Xr math 3 , 8161f28255Scgd.Xr sin 3 , 8261f28255Scgd.Xr sinh 3 , 8361f28255Scgd.Xr tan 3 , 84306d24c5Swiz.Xr tanh 3 85af726e9cSchristos.\" .Xr matherr 3 86899eb5a4Skleink.Sh STANDARDS 87899eb5a4SkleinkThe 88899eb5a4Skleink.Fn asin 89899eb5a4Skleinkfunction conforms to 907550e81bSmatt.St -isoC-99 . 91