man3/asin.3

   1 '\" t
   2 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
   3 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
   4 .\"     <mtk.manpages@gmail.com>
   5 .\"
   6 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
   7 .\"
   8 .\" References consulted:
   9 .\"     Linux libc source code
  10 .\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
  11 .\"     386BSD man pages
  12 .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu)
  13 .\" Modified 2002-07-25 by Walter Harms
  14 .\"     (walter.harms@informatik.uni-oldenburg.de)
  15 .\"
  16 .TH asin 3 (date) "Linux man-pages (unreleased)"
  17 .SH NAME
  18 asin, asinf, asinl \- arc sine function
  19 .SH LIBRARY
  20 Math library
  21 .RI ( libm ", " \-lm )
  22 .SH SYNOPSIS
  23 .nf
  24 .B #include <math.h>
  25 .P
  26 .BI "double asin(double " x );
  27 .BI "float asinf(float " x );
  28 .BI "long double asinl(long double " x );
  29 .fi
  30 .P
  31 .RS -4
  32 Feature Test Macro Requirements for glibc (see
  33 .BR feature_test_macros (7)):
  34 .RE
  35 .P
  36 .BR asinf (),
  37 .BR asinl ():
  38 .nf
  39     _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
  40         || /* Since glibc 2.19: */ _DEFAULT_SOURCE
  41         || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
  42 .fi
  43 .SH DESCRIPTION
  44 These functions calculate the principal value of the arc sine of
  45 .IR x ;
  46 that is the value whose sine is
  47 .IR x .
  48 .SH RETURN VALUE
  49 On success, these functions return the principal value of the arc sine of
  50 .I x
  51 in radians; the return value is in the range [\-pi/2,\ pi/2].
  52 .P
  53 If
  54 .I x
  55 is a NaN, a NaN is returned.
  56 .P
  57 If
  58 .I x
  59 is +0 (\-0),
  60 +0 (\-0) is returned.
  61 .P
  62 If
  63 .I x
  64 is outside the range [\-1,\ 1],
  65 a domain error occurs,
  66 and a NaN is returned.
  67 .\"
  68 .\" POSIX.1-2001 documents an optional range error for subnormal x;
  69 .\" glibc 2.8 does not do this.
  70 .SH ERRORS
  71 See
  72 .BR math_error (7)
  73 for information on how to determine whether an error has occurred
  74 when calling these functions.
  75 .P
  76 The following errors can occur:
  77 .TP
  78 Domain error: \fIx\fP is outside the range [\-1,\ 1]
  79 .I errno
  80 is set to
  81 .BR EDOM .
  82 An invalid floating-point exception
  83 .RB ( FE_INVALID )
  84 is raised.
  85 .SH ATTRIBUTES
  86 For an explanation of the terms used in this section, see
  87 .BR attributes (7).
  88 .TS
  89 allbox;
  90 lbx lb lb
  91 l l l.
  92 Interface       Attribute       Value
  93 T{
  94 .na
  95 .nh
  96 .BR asin (),
  97 .BR asinf (),
  98 .BR asinl ()
  99 T}      Thread safety   MT-Safe
 100 .TE
 101 .SH STANDARDS
 102 C11, POSIX.1-2008.
 103 .SH HISTORY
 104 C99, POSIX.1-2001.
 105 .P
 106 The variant returning
 107 .I double
 108 also conforms to
 109 SVr4, 4.3BSD, C89.
 110 .SH SEE ALSO
 111 .BR acos (3),
 112 .BR atan (3),
 113 .BR atan2 (3),
 114 .BR casin (3),
 115 .BR cos (3),
 116 .BR sin (3),
 117 .BR tan (3)