Debian Codegraph @

upstream/debian-trixie/man3/atan.3

raw
1 '\" t
2 .\" Copyright 1993 David Metcalfe ([email protected])
3 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
4 .\" <[email protected]>
5 .\"
6 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
7 .\"
8 .\" References consulted:
9 .\" Linux libc source code
10 .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
11 .\" 386BSD man pages
12 .\" Modified 1993-07-24 by Rik Faith ([email protected])
13 .\" Modified 2002-07-27 by Walter Harms
14 .\" ([email protected])
15 .\"
16 .TH atan 3 2024-05-02 "Linux man-pages 6.9.1"
17 .SH NAME
18 atan, atanf, atanl \- arc tangent function
19 .SH LIBRARY
20 Math library
21 .RI ( libm ", " \-lm )
22 .SH SYNOPSIS
23 .nf
24 .B #include <math.h>
25 .P
26 .BI "double atan(double " x );
27 .BI "float atanf(float " x );
28 .BI "long double atanl(long double " x );
29 .P
30 .fi
31 .RS -4
32 Feature Test Macro Requirements for glibc (see
33 .BR feature_test_macros (7)):
34 .RE
35 .P
36 .BR atanf (),
37 .BR atanl ():
38 .nf
39 _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
40 || /* Since glibc 2.19: */ _DEFAULT_SOURCE
41 || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
42 .fi
43 .SH DESCRIPTION
44 These functions calculate the principal value of the arc tangent of
45 .IR x ;
46 that is the value whose tangent is
47 .IR x .
48 .SH RETURN VALUE
49 On success, these functions return the principal value of the arc tangent of
50 .I x
51 in radians; the return value is in the range [\-pi/2,\ pi/2].
52 .P
53 If
54 .I x
55 is a NaN, a NaN is returned.
56 .P
57 If
58 .I x
59 is +0 (\-0),
60 +0 (\-0) is returned.
61 .P
62 If
63 .I x
64 is positive infinity (negative infinity), +pi/2 (\-pi/2) is returned.
65 .\"
66 .\" POSIX.1-2001 documents an optional range error for subnormal x;
67 .\" glibc 2.8 does not do this.
68 .SH ERRORS
69 No errors occur.
70 .SH ATTRIBUTES
71 For an explanation of the terms used in this section, see
72 .BR attributes (7).
73 .TS
74 allbox;
75 lbx lb lb
76 l l l.
77 Interface Attribute Value
78 T{
79 .na
80 .nh
81 .BR atan (),
82 .BR atanf (),
83 .BR atanl ()
84 T} Thread safety MT-Safe
85 .TE
86 .SH STANDARDS
87 C11, POSIX.1-2008.
88 .SH HISTORY
89 C99, POSIX.1-2001.
90 .P
91 The variant returning
92 .I double
93 also conforms to
94 SVr4, 4.3BSD, C89.
95 .SH SEE ALSO
96 .BR acos (3),
97 .BR asin (3),
98 .BR atan2 (3),
99 .BR carg (3),
100 .BR catan (3),
101 .BR cos (3),
102 .BR sin (3),
103 .BR tan (3)