FGETC — Read a single character in stream mode#
-
FGETC(UNIT, C)#
Read 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.
- Parameters
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.
- Standard:
GNU extension
- Class:
Subroutine, function
- Syntax:
CALL FGETC(UNIT, C [, STATUS]) STATUS = FGETC(UNIT, C)
- Example:
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
- See also:
FGET — Read a single character in stream mode from stdin, FPUT — Write a single character in stream mode to stdout, FPUTC — Write a single character in stream mode