gcc/fortran/doc/gfortran/intrinsic-procedures/acosd.rst

   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 .. _acosd:
   7
   8 .. index:: ACOSD
   9
  10 .. index:: DACOSD
  11
  12 .. index:: trigonometric function, cosine, inverse, degrees
  13
  14 .. index:: cosine, inverse, degrees
  15
  16 ACOSD --- Arccosine function, degrees
  17 *************************************
  18
  19 .. function:: ACOSD(X)
  20
  21   ``ACOSD(X)`` computes the arccosine of :samp:`{X}` in degrees (inverse of
  22   ``COSD(X)``).
  23
  24   :param X:
  25     The type shall either be ``REAL`` with a magnitude that is
  26     less than or equal to one - or the type shall 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     0 \leq \Re \acos(x) \leq 180.
  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 = ACOSD(X)
  43
  44   Example:
  45     .. code-block:: fortran
  46
  47       program test_acosd
  48         real(8) :: x = 0.866_8
  49         x = acosd(x)
  50       end program test_acosd
  51
  52   Specific names:
  53     .. list-table::
  54        :header-rows: 1
  55
  56        * - Name
  57          - Argument
  58          - Return type
  59          - Standard
  60
  61        * - ``ACOSD(X)``
  62          - ``REAL(4) X``
  63          - ``REAL(4)``
  64          - GNU extension
  65        * - ``DACOSD(X)``
  66          - ``REAL(8) X``
  67          - ``REAL(8)``
  68          - GNU extension
  69
  70   See also:
  71     Inverse function:
  72     :ref:`COSD`
  73     Radians function:
  74     :ref:`ACOS`