These are the usual arcsine, arccosine and arctangent functions, which are the inverses of the sine, cosine and tangent functions respectively.
double
asin (double x)
¶float
asinf (float x)
¶long double
asinl (long double x)
¶_FloatN
asinfN (_FloatN x)
¶_FloatNx
asinfNx (_FloatNx x)
¶Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.
These functions compute the arcsine of x—that is, the value whose
sine is x. The value is in units of radians. Mathematically,
there are infinitely many such values; the one actually returned is the
one between -pi/2
and pi/2
(inclusive).
The arcsine function is defined mathematically only
over the domain -1
to 1
. If x is outside the
domain, asin
signals a domain error.
double
acos (double x)
¶float
acosf (float x)
¶long double
acosl (long double x)
¶_FloatN
acosfN (_FloatN x)
¶_FloatNx
acosfNx (_FloatNx x)
¶Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.
These functions compute the arccosine of x—that is, the value
whose cosine is x. The value is in units of radians.
Mathematically, there are infinitely many such values; the one actually
returned is the one between 0
and pi
(inclusive).
The arccosine function is defined mathematically only
over the domain -1
to 1
. If x is outside the
domain, acos
signals a domain error.
double
atan (double x)
¶float
atanf (float x)
¶long double
atanl (long double x)
¶_FloatN
atanfN (_FloatN x)
¶_FloatNx
atanfNx (_FloatNx x)
¶Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.
These functions compute the arctangent of x—that is, the value
whose tangent is x. The value is in units of radians.
Mathematically, there are infinitely many such values; the one actually
returned is the one between -pi/2
and pi/2
(inclusive).
double
atan2 (double y, double x)
¶float
atan2f (float y, float x)
¶long double
atan2l (long double y, long double x)
¶_FloatN
atan2fN (_FloatN y, _FloatN x)
¶_FloatNx
atan2fNx (_FloatNx y, _FloatNx x)
¶Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.
This function computes the arctangent of y/x, but the signs
of both arguments are used to determine the quadrant of the result, and
x is permitted to be zero. The return value is given in radians
and is in the range -pi
to pi
, inclusive.
If x and y are coordinates of a point in the plane,
atan2
returns the signed angle between the line from the origin
to that point and the x-axis. Thus, atan2
is useful for
converting Cartesian coordinates to polar coordinates. (To compute the
radial coordinate, use hypot
; see Exponentiation and Logarithms.)
If both x and y are zero, atan2
returns zero.
double
asinpi (double x)
¶float
asinpif (float x)
¶long double
asinpil (long double x)
¶_FloatN
asinpifN (_FloatN x)
¶_FloatNx
asinpifNx (_FloatNx x)
¶Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.
These functions compute the arcsine of x, divided by pi. The
result is in the interval between -0.5
and 0.5
(inclusive).
The arcsine function is defined mathematically only over the domain
-1
to 1
. If x is outside the domain,
asinpi
signals a domain error.
The asinpi
functions are from TS 18661-4:2015.
double
acospi (double x)
¶float
acospif (float x)
¶long double
acospil (long double x)
¶_FloatN
acospifN (_FloatN x)
¶_FloatNx
acospifNx (_FloatNx x)
¶Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.
These functions compute the arccosine of x, divided by pi. The
result is in the interval between 0
and 1
(inclusive).
The arccosine function is defined mathematically only
over the domain -1
to 1
. If x is outside the
domain, acospi
signals a domain error.
The acospi
functions are from TS 18661-4:2015.
double
atanpi (double x)
¶float
atanpif (float x)
¶long double
atanpil (long double x)
¶_FloatN
atanpifN (_FloatN x)
¶_FloatNx
atanpifNx (_FloatNx x)
¶Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.
These functions compute the arctangent of x, divided by pi. The
result is in the interval between -0.5
and 0.5
(inclusive).
The atanpi
functions are from TS 18661-4:2015.
ISO C99 defines complex versions of the inverse trig functions.
complex double
casin (complex double z)
¶complex float
casinf (complex float z)
¶complex long double
casinl (complex long double z)
¶complex _FloatN
casinfN (complex _FloatN z)
¶complex _FloatNx
casinfNx (complex _FloatNx z)
¶Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.
These functions compute the complex arcsine of z—that is, the value whose sine is z. The value returned is in radians.
Unlike the real-valued functions, casin
is defined for all
values of z.
complex double
cacos (complex double z)
¶complex float
cacosf (complex float z)
¶complex long double
cacosl (complex long double z)
¶complex _FloatN
cacosfN (complex _FloatN z)
¶complex _FloatNx
cacosfNx (complex _FloatNx z)
¶Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.
These functions compute the complex arccosine of z—that is, the value whose cosine is z. The value returned is in radians.
Unlike the real-valued functions, cacos
is defined for all
values of z.
complex double
catan (complex double z)
¶complex float
catanf (complex float z)
¶complex long double
catanl (complex long double z)
¶complex _FloatN
catanfN (complex _FloatN z)
¶complex _FloatNx
catanfNx (complex _FloatNx z)
¶Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.
These functions compute the complex arctangent of z—that is, the value whose tangent is z. The value is in units of radians.