ICHAR (The GNU Fortran Compiler)

### 8.152 `ICHAR` — Character-to-integer conversion function ¶

Synopsis:

  `RESULT = ICHAR(C [, KIND])`

Description:

  `ICHAR(C)` returns the code for the character in the first character position of `C` in the system’s native character set. The correspondence between characters and their codes is not necessarily the same across different GNU Fortran implementations.

Class:

  Elemental function

Arguments:

  C | Shall be a scalar `CHARACTER`, with `INTENT(IN)`
  KIND | (Optional) A scalar `INTEGER` constant expression indicating the kind parameter of the result.

Return value:

  The return value is of type `INTEGER` and of kind KIND. If KIND is absent, the return value is of default integer kind.

Example:

      program test_ichar
        integer i
        i = ichar(' ')
      end program test_ichar

Specific names:

  Name | Argument | Return type | Standard
  --- | --- | --- | ---
  `ICHAR(C)` | `CHARACTER C` | `INTEGER(4)` | Fortran 77 and later

Notes:

  No intrinsic exists to convert between a numeric value and a formatted character string representation – for instance, given the `CHARACTER` value `'154'`, obtaining an `INTEGER` or `REAL` value with the value 154, or vice versa. Instead, this functionality is provided by internal-file I/O, as in the following example:

      program read_val
        integer value
        character(len=10) string, string2
        string = '154'

        ! Convert a string to a numeric value
        read (string,'(I10)') value
        print *, value

        ! Convert a value to a formatted string
        write (string2,'(I10)') value
        print *, string2
      end program read_val

Standard:

  Fortran 77 and later, with KIND argument Fortran 2003 and later

See also:

  `ACHAR` — Character in ASCII collating sequence,
  `CHAR` — Character conversion function,
  `IACHAR` — Code in ASCII collating sequence