9.99 FGETC — Чтение одного символа в режиме потока

Описание:

Считывает один символ в режиме потока, минуя обычный форматированный вывод. Ввод-вывод потоков не следует смешивать с обычным вводом-выводом по записям (форматированным или неформатированным) на одном устройстве; результаты будут непредсказуемыми.

Этот встроенный элемент предоставляется как в виде подпрограммы, так и в виде функции; однако в любом заданном программном модуле может быть использован только один вариант.

Обратите внимание, что встроенный элемент FGET предоставляется для обратной совместимости с g77. GNU Fortran предоставляет потоковый механизм Fortran 2003. Программисты должны учитывать использование новой функции потокового ввода-вывода в новом коде для будущей портативности. См. также статус Fortran 2003.

Стандарт:

Расширение GNU

Класс:

Подпрограмма, функция

Синтаксис:

CALL FGETC(UNIT, C [, STATUS])

STATUS = FGETC(UNIT, C)

Аргументы:

UNIT	Тип должен быть INTEGER.
C	Тип должен быть CHARACTER и иметь стандартный вид.
STATUS	(Необязательно) флаг состояния типа INTEGER. Возвращает 0 при успехе, -1 при достижении конца файла и системную положительную ошибку в противном случае.

Пример:

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

См. также:

FGET, FPUT, FPUTC