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

asind(3M) asind(3M)

NAME

asind( ), asindf( ), asindl( ), asindw( ), asindq( ) - degree-valued arcsine functions

SYNOPSIS

#include <math.h>

double asind(double x);

float asindf(float x);

Itanium(R)-based System Only

long double asindl(long double x);

extended asindw(extended x);

quad asindq(quad x);

DESCRIPTION

asind() returns the degree-valued arcsine of x, in the range −90 to 90.

asindf() is a float version of asind(); it takes a

float argument and returns a float result.

Itanium-based System Only

asindl() is a long double version of asind(); it takes a long double argument and returns a

long double result.

asindw() is an extended version of asind(); it takes an extended argument and returns an

extended result.

asindq() is equivalent to asindl() 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 Itanium-based systems)

asindw() or asindq(), 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

asind(±0) returns ±0.

If the magnitude of x is greater than one,

asind() returns NaN and raises the invalid exception.

If x is NaN,

asind() returns NaN.

ERRORS

If the magnitude of x is greater than one,

asind() sets errno to [EDOM].

Itanium-based System

HP-UX

libm functions on Itanium-based system do not set errno by default. For errno setting, com-

pile with the +Olibmerrno option.