gcc/fortran/doc/gfortran/intrinsic-procedures/lge.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 .. _lge:
   7
   8 .. index:: LGE
   9
  10 .. index:: lexical comparison of strings
  11
  12 .. index:: string, comparison
  13
  14 LGE --- Lexical greater than or equal
  15 *************************************
  16
  17 .. function:: LGE(STRING_A, STRING_B)
  18
  19   Determines whether one string is lexically greater than or equal to
  20   another string, where the two strings are interpreted as containing
  21   ASCII character codes.  If the String A and String B are not the same
  22   length, the shorter is compared as if spaces were appended to it to form
  23   a value that has the same length as the longer.
  24
  25   :param STRING_A:
  26     Shall be of default ``CHARACTER`` type.
  27
  28   :param STRING_B:
  29     Shall be of default ``CHARACTER`` type.
  30
  31   :return:
  32     Returns ``.TRUE.`` if ``STRING_A >= STRING_B``, and ``.FALSE.``
  33     otherwise, based on the ASCII ordering.
  34
  35   Standard:
  36     Fortran 77 and later
  37
  38   Class:
  39     Elemental function
  40
  41   Syntax:
  42     .. code-block:: fortran
  43
  44       RESULT = LGE(STRING_A, STRING_B)
  45
  46   Specific names:
  47     .. list-table::
  48        :header-rows: 1
  49
  50        * - Name
  51          - Argument
  52          - Return type
  53          - Standard
  54
  55        * - ``LGE(STRING_A,STRING_B)``
  56          - ``CHARACTER``
  57          - ``LOGICAL``
  58          - Fortran 77 and later
  59
  60   See also:
  61     :ref:`LGT`,
  62     :ref:`LLE`,
  63     :ref:`LLT`