lge(3I)

NAME
     LGE, LGT, LLE, LLT - Compares strings lexically

SYNOPSIS
     LGE ([STRING_A=]string_a, [STRING_B=]string_b)

     LGT ([STRING_A=]string_a, [STRING_B=]string_b)

     LLE ([STRING_A=]string_a, [STRING_B=]string_b)

     LLT ([STRING_A=]string_a, [STRING_B=]string_b)

IMPLEMENTATION
     UNICOS, UNICOS/mk, IRIX systems

     CF90, MIPSpro 7 Fortran 90, MIPSpro Fortran 77

STANDARDS
     Fortran

DESCRIPTION
     Each of these type logical functions takes two character string
     arguments and returns a logical value.  string_a and string_b are
     compared according to the ASCII collating sequence, and the resulting
     true or false value is returned.

     string_a and string_b    Must be of type default character

     The defining equation for each function is as follows:

     * For LGE, logic = a  is greater than or equal to a
                         1                              2
     * For LGT, logic = a  is greater than a
                         1                  2
     * For LLE, logic = a  is less than or equal to a
                         1                           2
     * For LLT, logic = a  is less than a
                         1               2
     LGE, LGT, LLE, and LLT are elemental functions.  The names of these
     intrinsics cannot be passed as arguments.

RETURN VALUES
     If the strings are of unequal length, the comparison is made as if the
     shorter string were extended on the right with blanks to the length of
     the longer string.  The return value of each intrinsic is as follows:

     * LGE.  The result is true if the strings are equal or if string_a
       follows string_b in the ASCII collating sequence; otherwise, the
       result is false.  Note that the result is true if both string_a and
       string_b are of equal length; this includes zero-length strings.

     * LGT.  The result is true if string_a follows string_b in the ASCII
       collating sequence; otherwise, it is false.  The result is false if
       both string_a and string_b are of zero length.

     * LLE.  The result is true if the strings are equal or if string_a
       precedes string_b in the ASCII collating sequence; otherwise, it is
       false.  Note that the result is true if both string_a and string_b
       are of equal length; this includes zero-length strings.

     * LLT.  The result is true if string_a precedes string_b in the ASCII
       collating sequence; otherwise, it is false.  The result is false if
       both string_a and string_b are of zero length.

NOTES
     When using the MIPSpro Fortran 77 compiler, the -i2 command line
     option can affect the size of the value returned.

     When using the CF90 or MIPSpro 7 Fortran 90 compilers, the return
     value is of type default logical.

SEE ALSO
     Intrinsic Procedures Reference Manual for the printed version of this
     man page.