xref: /csrg-svn/lib/libm/common_source/asin.3 (revision 61283)
1*61283Sbostic.\" Copyright (c) 1991, 1993
2*61283Sbostic.\"	The Regents of the University of California.  All rights reserved.
348918Scael.\"
448918Scael.\" %sccs.include.redist.man%
548918Scael.\"
6*61283Sbostic.\"     @(#)asin.3	8.1 (Berkeley) 06/04/93
748918Scael.\"
848918Scael.Dd
948918Scael.Dt ASIN 3
1048918Scael.Os
1148918Scael.Sh NAME
1248918Scael.Nm asin
1348918Scael.Nd arc sine function
1448918Scael.Sh SYNOPSIS
1548918Scael.Fd #include <math.h>
1648918Scael.Ft double
1748918Scael.Fn asin "double  x"
1848918Scael.Sh DESCRIPTION
1948918ScaelThe
2048918Scael.Fn asin
2148918Scaelfunction computes the principal value of the arc sine of
2248918Scael.Fa x .
2348918ScaelA domain error occurs for arguments not in the range [-1, +1].
2448918ScaelFor a discussion of error due to roundoff, see
2548918Scael.Xr math 3 .
2648918Scael.Sh RETURN VALUES
2748918ScaelThe
2848918Scael.Fn asin
2948918Scaelfunction returns the arc sine in the range
3048918Scael.Bk -words
3148918Scael.Bq -\*(Pi/2, +\*(Pi/2
3248918Scael.Ek
3348918Scaelradians.
3448918ScaelOn the
3548918Scael.Tn VAX ,
3648918Scaeland Tahoe ,
3748918Scaelif:
3848918Scael.Bd -unfilled -offset indent
3948918Scael.Pf \&| Ns Ar x Ns \&| > 1
4048918Scael.Ed
4148918Scael.Pp
4248918Scaelthe
4348918Scaelglobal variable
4448918Scael.Va errno
4548918Scaelis set to
4648918Scael.Er EDOM
4748918Scaeland
4848918Scaela reserved operand fault generated.
4948918Scael.Sh SEE ALSO
5048918Scael.Xr acos 3 ,
5148918Scael.Xr atan 3 ,
5248918Scael.Xr atan2 3 ,
5348918Scael.Xr cos 3 ,
5448918Scael.Xr cosh 3 ,
5548918Scael.Xr sin 3 ,
5648918Scael.Xr sinh 3 ,
5748918Scael.Xr tan 3 ,
5848918Scael.Xr tanh 3 ,
5948918Scael.Xr math 3 ,
6048918Scael.Sh STANDARDS
6148918ScaelThe
6248918Scael.Fn asin
6348918Scaelfunction conforms to
6448918Scael.St -ansiC .
65