NAME
cbrt(), cbrtf(), cbrtl(), cbrtw(), cbrtq() — cube root functions
SYNOPSIS
#include <math.h>
double cbrt(double x);
float cbrtf(float x);
HP Integrity Server Only
long double cbrtl(long double x);
extended cbrtw(extended x);
quad cbrtq(quad x);
DESCRIPTION
cbrt()
computes the cube root of
x.
cbrtf()
is a
float
version of
cbrt();
it takes a
float
argument and returns a
float
result.
Integrity Server Only
cbrtl()
is a
long double
version of
cbrt();
it takes a
long double
argument and returns a
long double
result.
cbrtw()
is an
extended
version of
cbrt();
it takes an
extended
argument and returns an
extended
result.
cbrtq()
is equivalent to
cbrtl()
on HP-UX systems.
USAGE
To use these functions,
compile either with the default
-Ae
option or with the
-Aa
and
-D_HPUX_SOURCE
options.
To use (for Integrity servers)
cbrtw()
or
cbrtq(),
compile also with the
-fpwidetypes
option.
To use any of these functions, make sure your program includes
<math.h>,
and link in the math library by specifying
-lm
on the compiler or linker command line.
For more information, see the
HP-UX floating-point guide for HP Integrity servers
at the following site:
http://www.hp.com/go/fp.
RETURN VALUE
If
x
is
±INFINITY or ±zero,
cbrt()
returns
x.
If
x
is NaN,
cbrt()
returns NaN.
cbrt()
raises the inexact exception whenever a rounded result does not equal
the mathematical result.
ERRORS
No errors are defined.
STANDARDS CONFORMANCE
cbrt()
: SVID3, XPG4.2, ISO/IEC C99
(including Annex F, ``IEC 60559 floating-point arithmetic'')
cbrtf(),
cbrtl()
: ISO/IEC C99 (including Annex F, ``IEC 60559 floating-point arithmetic'')