|
|
1.1 root 1: .\"#ident "@(#)ccsman:g3m/trig.3m 1.2"
2: .ds x} TRIG 3M "630 MTG" "\&"
3: .TH \*(x}
4: .SH NAME
5: trig: sin, cos, tan, asin, acos, atan, atan2 \- trigonometric functions
6: .SH SYNOPSIS
7: .B #include <ccs/math.h>
8: .PP
9: .B double sin (x)
10: .br
11: .B double x;
12: .PP
13: .B double cos (x)
14: .br
15: .B double x;
16: .PP
17: .B double tan (x)
18: .br
19: .B double x;
20: .PP
21: .B double asin (x)
22: .br
23: .B double x;
24: .PP
25: .B double acos (x)
26: .br
27: .B double x;
28: .PP
29: .B double atan (x)
30: .br
31: .B double x;
32: .PP
33: .B double atan2 (y, x)
34: .br
35: .B double y, x;
36: .SH DESCRIPTION
37: .IR Sin ,
38: .I cos\^
39: and
40: .I tan\^
41: return respectively the sine, cosine and tangent of their argument,
42: .IR x ,
43: measured in radians.
44: .PP
45: .I Asin\^
46: returns the arcsine of
47: .IR x ,
48: in the range \-\(*p/2 to \(*p/2.
49: .PP
50: .I Acos\^
51: returns the arccosine of
52: .IR x ,
53: in the range 0 to \(*p.
54: .PP
55: .I Atan\^
56: returns the arctangent of
57: .IR x ,
58: in the range \-\(*p/2 to \(*p/2.
59: .PP
60: .I Atan2\^
61: returns the arctangent of
62: .IR y / x ,
63: in the range \-\(*p to \(*p,
64: using the signs of both arguments
65: to determine the quadrant of the return value.
66: .SH SEE ALSO
67: matherr(3M).
68: .SH DIAGNOSTICS
69: .IR Sin ,
70: .IR cos ,
71: and
72: .I tan\^
73: lose accuracy when their argument is far from zero.
74: For arguments sufficiently large,
75: these functions return zero when there would
76: otherwise be a complete loss of significance.
77: In this case, a message indicating \s-1TLOSS\s+1 error is
78: displayed.
79: For less extreme arguments causing partial loss of significance,
80: a \s-1PLOSS\s+1 error is generated but no message is displayed.
81: In both cases,
82: .I errno\^
83: is set to
84: .SM
85: .B ERANGE.
86: .bp
87: .PP
88: If the magnitude of the argument of
89: .IR asin " or " acos
90: is greater than one,
91: or if both arguments of
92: .I atan2\^
93: are zero,
94: zero is returned and
95: .I errno\^
96: is set to
97: .SM
98: .BR EDOM .
99: In addition, a message indicating \s-1DOMAIN\s+1 error is
100: displayed.
101: .PP
102: These error-handling procedures may be changed with the function
103: .IR matherr (3M).
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.