C Language and Libraries Help (clang.hlp) (
Table of Contents;
Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
Trigonometric Functions
◄Summary► ◄Example► ◄Up► ◄Contents► ◄Index► ◄Back►
─────Run-Time Library───────────────────────────────────────────────────────
The acos, asin, atan, and atan2 functions return the arccosine,
the arcsine, and the arctangent values of <x>, respectively. The
argument <x> is specified in radians. The atan2 function uses the
signs of both arguments to determine the quadrant of the return
value. The functions, argument ranges, and return value ranges are
listed below:
Function Argument Range Return Value Range
acos -1 to 1 0 to π
asin -1 to 1 -π/2 to π/2
atan No limit -π/2 to π/2
atan2 No limit -π to π
The 8087 family of numeric coprocessor chips supports the 80-bit
precision floating-point data type. Beginning with Microsoft C
version 6.0, the long double functions, whoses names end with 'l',
map the C long double type into this 80-bit, 10-byte form. Unlike
the regular floating-point functions (such as acos), which accept
and return values of type double, these long double forms (such as
_acosl) accept and return values of type long double. In all other
respects, they are identical to the regular functions.
For the acos and asin functions, <x> must be between -1 and 1. If
<x> is less than -1 or greater than 1, acos and asin set errno to
EDOM, print a _DOMAIN error message to stderr, and return 0.
The atan2 functions are well defined for every point other than
the origin, even if <x> equals 0 and <y> does not equal 0.
If both arguments to atan2 are 0, the function sets errno to EDOM,
prints a _DOMAIN error message to stderr, and returns 0.
Error handling can be modified with the _matherr (or _matherrl)
routine.
Return Value
The return values for these functions are described above.
-♦-