HPlogo HP-UX Reference > S

sqrt(3M)

HP-UX 11i Version 2: December 2007 Update
» 

Technical documentation

 » Table of Contents

 » Index

NAME

sqrt(), sqrtf(), sqrtl(), sqrtw(), sqrtq() — square root functions

SYNOPSIS

#include <math.h>

double sqrt(double x);

float sqrtf(float x);

Itanium(R)-based System Only

long double sqrtl(long double x);

extended sqrtw(extended x);

quad sqrtq(quad x);

DESCRIPTION

sqrt() returns the non-negative square root of x.

sqrtf() is a float version of sqrt(); it takes a float argument and returns a float result.

Itanium-based System Only

sqrtl() is a long double version of sqrt(); it takes a long double argument and returns a long double result.

sqrtw() is an extended version of sqrt(); it takes an extended argument and returns an extended result.

sqrtq() is equivalent to sqrtl() on HP-UX systems.

USAGE

To use these functions compile either with the default -Ae option or with the -Aa and the -D_HPUX_SOURCE options.

To use (for Itanium-based systems) sqrtw() or sqrtq(), 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, sqrt() returns +INFINITY.

If x is NaN, sqrt() returns NaN.

If x is less than zero, sqrt() returns NaN and raises the invalid floating-point exception.

sqrt() raises the inexact exception whenever a rounded result does not equal the mathematical result.

ERRORS

If x is less than zero, sqrt() sets errno to [EDOM].

Itanium-based System Only

HP-UX libm functions on Itanium-based systems do not set errno by default. For errno setting, compile with the +Olibmerrno option and the (default) +Olibcalls option.

STANDARDS CONFORMANCE

sqrt() : SVID3, XPG4.2, ANSI C, ISO/IEC C99 (including Annex F, ``IEC 60559 floating-point arithmetic'')

sqrtf(), sqrtl() : ISO/IEC C99 (including Annex F, ``IEC 60559 floating-point arithmetic'')