6.11.13 asinl Function

Calculates the trigonometric arc sine function of a double precision floating-point value.

Include

<math.h>

Prototype

long double asinl(long double x);

Argument

x

value between -1 and 1 for which to return the arc sine

Return Value

Returns the arc sine in radians in the range $\mathrm{[-\pi /2,\; +\pi /2]}$ radians (inclusive) or NaN if a domain error occurs.

Remarks

If x is less than -1 or greater than 1, a domain error will occur and errno will be set to EDOM.

Example

See the notes at the beginning of this chapter or section for information on using printf() or scanf() (and other functions reading and writing the stdin or stdout streams) in the example code.

#include <math.h>
#include <stdio.h>
#include <errno.h>

int main(void)
{
  long double x, y;

  errno = 0;
  x = 2.0;
  y = asinl(x);
  if (errno)
    perror("Error");
  printf("The arcsine of %Lf is %Lf\n", x, y);

  errno = 0;
  x = 0.0;
  y = asinl(x);
  if (errno)
    perror("Error");
  printf("The arcsine of %Lf is %Lf\n", x, y);
}

Example Output

Error: Domain error
The arcsine of 2.000000 is nan
The arcsine of 0.000000 is 0.000000