HP-UX Reference (11i v2 04/09) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

141

142

143

144

145

146

147

148

149

150

cbrt(3M) cbrt(3M)

NAME

cbrt(), cbrtf(), cbrtl(), cbrtw(), cbrtq() - cube root functions

SYNOPSIS

#include <math.h>

double cbrt(double x);

float cbrtf(float x);

Itanium-based Systems 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.

Itanium-based Systems 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

cbrtw() or cbrtq() (on Itanium-based systems), 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.

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 deﬁned.