1ASIN(3)                    Linux Programmer's Manual                   ASIN(3)
2
3
4

NAME

6       asin, asinf, asinl - arc sine function
7

SYNOPSIS

9       #include <math.h>
10
11       double asin(double x);
12       float asinf(float x);
13       long double asinl(long double x);
14
15       Link with -lm.
16
17   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
18
19       asinf(), asinl(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600
20       || _ISOC99_SOURCE; or cc -std=c99
21

DESCRIPTION

23       The asin() function calculates the principal value of the arc  sine  of
24       x; that is the value whose sine is x.
25

RETURN VALUE

27       On  success, these functions return the principal value of the arc sine
28       of x in radians; the return value is in the range [-pi/2, pi/2].
29
30       If x is a NaN, a NaN is returned.
31
32       If x is +0 (-0), +0 (-0) is returned.
33
34       If x is outside the range [-1, 1], a domain error occurs, and a NaN  is
35       returned.
36

ERRORS

38       See  math_error(7) for information on how to determine whether an error
39       has occurred when calling these functions.
40
41       The following errors can occur:
42
43       Domain error: x is outside the range [-1, 1]
44              errno is set  to  EDOM.   An  invalid  floating-point  exception
45              (FE_INVALID) is raised.
46

CONFORMING TO

48       C99, POSIX.1-2001.  The variant returning double also conforms to SVr4,
49       4.3BSD, C89.
50

SEE ALSO

52       acos(3), atan(3), atan2(3), casin(3), cos(3), sin(3), tan(3)
53

COLOPHON

55       This page is part of release 3.25 of the Linux  man-pages  project.   A
56       description  of  the project, and information about reporting bugs, can
57       be found at http://www.kernel.org/doc/man-pages/.
58
59
60
61                                  2008-08-05                           ASIN(3)
Impressum