NAME

asin(), asinf() − arcsine functions

SYNOPSIS

#include <math.h>

double asin(double x);

float asinf(float x);

DESCRIPTION

asin() returns the arcsine of x in the range −π/2 to π/2. 

asinf() is a float version of asin(); it takes a float argument and returns a float result.  To use this function, compile either with the −Ae option or with the −Aa and −D_HPUX_SOURCE options.  Otherwise, the compiler promotes the float argument to double, and the function returns incorrect results. 

asinf() is not specified by any standard, but it is named in accordance with the conventions specified in the "Future Library Directions" section of the ANSI C standard. 

To use these functions, link in the math library by specifying −lm on the compiler or linker command line. 

RETURN VALUE

If x is NaN, asin() returns NaN. 

If the magnitude of x is greater than one, asin() returns zero and sets errno to [EDOM]. 

ERRORS

If asin() fails, errno is set to the following value. 

[EDOM] The magnitude of x is greater than one. 

DEPENDENCIES

Millicode versions of the asin() function are available on PA1.1-based and PA2.0-based systems, in the library /usr/lib/milli.a.  Millicode versions of math library functions are usually faster than their counterparts in the standard library.  To use these versions, compile your program with the +DA1.1 option (the default on PA1.1-based systems) or the +DA2.0 option (the default on PA2.0-based systems) and with the +Olibcalls or the +Oaggressive optimization option. 

If an error occurs, the millicode versions return the value described in the RETURN VALUE section, but do not set errno. 

For more information, see the HP-UX Floating-Point Guide.

SEE ALSO

asind(3M), sin(3M), cos(3M), tan(3M), acos(3M), atan(3M), atan2(3M), isinf(3M), isnan(3M). 

STANDARDS CONFORMANCE

asin(): SVID3, XPG4.2, ANSI C

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996