summaryrefslogtreecommitdiffstats
path: root/man3/asin.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/asin.3')
-rw-r--r--man3/asin.367
1 files changed, 67 insertions, 0 deletions
diff --git a/man3/asin.3 b/man3/asin.3
new file mode 100644
index 000000000..76c7133c1
--- /dev/null
+++ b/man3/asin.3
@@ -0,0 +1,67 @@
+.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
+.\"
+.\" Permission is granted to make and distribute verbatim copies of this
+.\" manual provided the copyright notice and this permission notice are
+.\" preserved on all copies.
+.\"
+.\" Permission is granted to copy and distribute modified versions of this
+.\" manual under the conditions for verbatim copying, provided that the
+.\" entire resulting derived work is distributed under the terms of a
+.\" permission notice identical to this one.
+.\"
+.\" Since the Linux kernel and libraries are constantly changing, this
+.\" manual page may be incorrect or out-of-date. The author(s) assume no
+.\" responsibility for errors or omissions, or for damages resulting from
+.\" the use of the information contained herein. The author(s) may not
+.\" have taken the same level of care in the production of this manual,
+.\" which is licensed free of charge, as they might when working
+.\" professionally.
+.\"
+.\" Formatted or processed versions of this manual, if unaccompanied by
+.\" the source, must acknowledge the copyright and authors of this work.
+.\"
+.\" References consulted:
+.\" Linux libc source code
+.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
+.\" 386BSD man pages
+.\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu)
+.\" Modified 2002-07-25 by Walter Harms
+.\" (walter.harms@informatik.uni-oldenburg.de)
+.\"
+.TH ASIN 3 2002-07-25 "" "Linux Programmer's Manual"
+.SH NAME
+asin, asinf, asinl \- arc sine function
+.SH SYNOPSIS
+.nf
+.B #include <math.h>
+.sp
+.BI "double asin(double " x );
+.br
+.BI "float asinf(float " x );
+.br
+.BI "long double asinl(long double " x );
+.fi
+.sp
+Link with \-lm.
+.SH DESCRIPTION
+The \fBasin()\fP function calculates the arc sine of \fIx\fP; that is
+the value whose sine is \fIx\fP. If \fIx\fP falls outside the range
+\-1 to 1, \fBasin()\fP fails and \fIerrno\fP is set.
+.SH "RETURN VALUE"
+The \fBasin()\fP function returns the arc sine in radians and the
+value is mathematically defined to be between -PI/2 and PI/2
+(inclusive).
+.SH ERRORS
+.TP
+.B EDOM
+\fIx\fP is out of range.
+.SH "CONFORMING TO"
+SVID 3, POSIX, BSD 4.3, ISO 9899.
+The float and long double variants are C99 requirements.
+.SH "SEE ALSO"
+.BR acos (3),
+.BR atan (3),
+.BR atan2 (3),
+.BR cos (3),
+.BR sin (3),
+.BR tan (3)