FGET — Read a single character in stream mode from stdin#

FGET(C)#

Read a single character in stream mode from stdin by bypassing normal formatted output. Stream I/O should not be mixed with normal record-oriented (formatted or unformatted) I/O on the same unit; the results are unpredictable.

Parameters
  • C – The type shall be CHARACTER and of default kind.

  • STATUS – (Optional) status flag of type INTEGER. Returns 0 on success, -1 on end-of-file, and a system specific positive error code otherwise.

Standard:

GNU extension

Class:

Subroutine, function

Syntax:
CALL FGET(C [, STATUS])
STATUS = FGET(C)
Example:
PROGRAM test_fget
  INTEGER, PARAMETER :: strlen = 100
  INTEGER :: status, i = 1
  CHARACTER(len=strlen) :: str = ""

  WRITE (*,*) 'Enter text:'
  DO
    CALL fget(str(i:i), status)
    if (status /= 0 .OR. i > strlen) exit
    i = i + 1
  END DO
  WRITE (*,*) TRIM(str)
END PROGRAM
See also:

FGETC — Read a single character in stream mode, FPUT — Write a single character in stream mode to stdout, FPUTC — Write a single character in stream mode