LGE(3I) Last changed: 1-6-98
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, and IRIX systems
STANDARDS
Fortran 90
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.
SEE ALSO
Intrinsic Procedures Reference Manual, publication SR-2138, for the
printed version of this man page.