]>
Commit | Line | Data |
---|---|---|
1 | .. | |
2 | Copyright 1988-2022 Free Software Foundation, Inc. | |
3 | This is part of the GCC manual. | |
4 | For copying conditions, see the copyright.rst file. | |
5 | ||
6 | .. _asind: | |
7 | ||
8 | .. index:: ASIND | |
9 | ||
10 | .. index:: DASIND | |
11 | ||
12 | .. index:: trigonometric function, sine, inverse, degrees | |
13 | ||
14 | .. index:: sine, inverse, degrees | |
15 | ||
16 | ASIND --- Arcsine function, degrees | |
17 | *********************************** | |
18 | ||
19 | .. function:: ASIND(X) | |
20 | ||
21 | ``ASIND(X)`` computes the arcsine of its :samp:`{X}` in degrees (inverse of | |
22 | ``SIND(X)``). | |
23 | ||
24 | :param X: | |
25 | The type shall be either ``REAL`` and a magnitude that is | |
26 | less than or equal to one - or be ``COMPLEX``. | |
27 | ||
28 | :return: | |
29 | The return value is of the same type and kind as :samp:`{X}`. | |
30 | The real part of the result is in degrees and lies in the range | |
31 | -90 \leq \Re \asin(x) \leq 90. | |
32 | ||
33 | Standard: | |
34 | GNU extension, enabled with :option:`-fdec-math`. | |
35 | ||
36 | Class: | |
37 | Elemental function | |
38 | ||
39 | Syntax: | |
40 | .. code-block:: fortran | |
41 | ||
42 | RESULT = ASIND(X) | |
43 | ||
44 | Example: | |
45 | .. code-block:: fortran | |
46 | ||
47 | program test_asind | |
48 | real(8) :: x = 0.866_8 | |
49 | x = asind(x) | |
50 | end program test_asind | |
51 | ||
52 | Specific names: | |
53 | .. list-table:: | |
54 | :header-rows: 1 | |
55 | ||
56 | * - Name | |
57 | - Argument | |
58 | - Return type | |
59 | - Standard | |
60 | ||
61 | * - ``ASIND(X)`` | |
62 | - ``REAL(4) X`` | |
63 | - ``REAL(4)`` | |
64 | - GNU extension | |
65 | * - ``DASIND(X)`` | |
66 | - ``REAL(8) X`` | |
67 | - ``REAL(8)`` | |
68 | - GNU extension | |
69 | ||
70 | See also: | |
71 | Inverse function: | |
72 | :ref:`SIND` | |
73 | Radians function: | |
74 | :ref:`ASIN` |