Next: FINDLOC, Previous: FGET, Up: Intrinsic Procedures [Contents][Index]
FGETC
— Read a single character in stream modeRead a single character in stream mode 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.
This intrinsic is provided in both subroutine and function forms; however, only one form can be used in any given program unit.
Note that the FGET
intrinsic is provided for backwards compatibility
with g77
. GNU Fortran provides the Fortran 2003 Stream facility.
Programmers should consider the use of new stream IO feature in new code
for future portability. See also Fortran 2003 status.
GNU extension
Subroutine, function
CALL FGETC(UNIT, C [, STATUS]) |
STATUS = FGETC(UNIT, C) |
UNIT | The type shall be INTEGER . |
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. |
PROGRAM test_fgetc INTEGER :: fd = 42, status CHARACTER :: c OPEN(UNIT=fd, FILE="/etc/passwd", ACTION="READ", STATUS = "OLD") DO CALL fgetc(fd, c, status) IF (status /= 0) EXIT call fput(c) END DO CLOSE(UNIT=fd) END PROGRAM