9.107 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