ICHAR(C, KIND)

Purpose

Returns the position of a character in the collating sequence associated with the kind type parameter of the character.

Class

Elemental function

Argument type and attributes

C

An INTENT(IN) CHARACTER of length one. Its value must be that of a representable character.

KIND (optional)

An INTENT(IN) INTEGER scalar. The actual argument corresponding to KIND must be a constant expression.

Result type and attributes

• It is of type integer.
• If KIND is present, the KIND type parameter is that specified by the value of KIND; otherwise, the KIND type parameter is that of default integer type.

Result value

• The result is the position of C in the collating sequence associated with the kind type parameter of C and is in the range 0 ≤ ICHAR (C) ≤ 127.
• For any representable characters C and D, C .LE. D is true if and only if ICHAR (C) .LE. ICHAR (D) is true and C .EQ. D is true if and only if ICHAR (C) .EQ. ICHAR (D) is true.