Debian Codegraph @

upstream/debian-unstable/man3/asin.3

raw
1 '\" t
2 .\" Copyright 1993, David Metcalfe <[email protected]>
3 .\" Copyright, the authors of the Linux man-pages project
4 .\"
5 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
6 .\"
7 .TH asin 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 asin, asinf, asinl \- arc sine function
10 .SH LIBRARY
11 Math library
12 .RI ( libm ,\~ \-lm )
13 .SH SYNOPSIS
14 .nf
15 .B #include <math.h>
16 .P
17 .BI "double asin(double " x );
18 .BI "float asinf(float " x );
19 .BI "long double asinl(long double " x );
20 .fi
21 .P
22 .RS -4
23 Feature Test Macro Requirements for glibc (see
24 .BR feature_test_macros (7)):
25 .RE
26 .P
27 .BR asinf (),
28 .BR asinl ():
29 .nf
30 _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
31 || /* Since glibc 2.19: */ _DEFAULT_SOURCE
32 || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
33 .fi
34 .SH DESCRIPTION
35 These functions calculate the principal value of the arc sine of
36 .IR x ;
37 that is the value whose sine is
38 .IR x .
39 .SH RETURN VALUE
40 On success,
41 these functions return the principal value of the arc sine of
42 .I x
43 in radians;
44 the return value is in the range [\-pi/2,\ pi/2].
45 .P
46 If
47 .I x
48 is a NaN,
49 a NaN is returned.
50 .P
51 If
52 .I x
53 is +0 (\-0),
54 +0 (\-0) is returned.
55 .P
56 If
57 .I x
58 is outside the range [\-1,\ 1],
59 a domain error occurs,
60 and a NaN is returned.
61 .\"
62 .\" POSIX.1-2001 documents an optional range error for subnormal x;
63 .\" glibc 2.8 does not do this.
64 .SH ERRORS
65 See
66 .BR math_error (7)
67 for information on how to determine whether an error has occurred
68 when calling these functions.
69 .P
70 The following errors can occur:
71 .TP
72 Domain error: \f[I]x\f[] is outside the range [\-1,\ 1]
73 .I errno
74 is set to
75 .BR EDOM .
76 An invalid floating-point exception
77 .RB ( FE_INVALID )
78 is raised.
79 .SH ATTRIBUTES
80 For an explanation of the terms used in this section, see
81 .BR attributes (7).
82 .TS
83 allbox;
84 lbx lb lb
85 l l l.
86 Interface Attribute Value
87 T{
88 .na
89 .nh
90 .BR asin (),
91 .BR asinf (),
92 .BR asinl ()
93 T} Thread safety MT-Safe
94 .TE
95 .SH STANDARDS
96 C11, POSIX.1-2008.
97 .SH HISTORY
98 C99, POSIX.1-2001.
99 .P
100 The variant returning
101 .I double
102 also conforms to
103 SVr4, 4.3BSD, C89.
104 .SH SEE ALSO
105 .BR acos (3),
106 .BR atan (3),
107 .BR atan2 (3),
108 .BR casin (3),
109 .BR cos (3),
110 .BR sin (3),
111 .BR tan (3)