gcc/fortran/doc/gfortran/intrinsic-procedures/fstat.rst

   1 ..
   2   Copyright 1988-2022 Free Software Foundation, Inc.
   3   This is part of the GCC manual.
   4   For copying conditions, see the copyright.rst file.
   5
   6 .. _fstat:
   7
   8 FSTAT --- Get file status
   9 *************************
  10
  11 .. index:: FSTAT, file system, file status
  12
  13 .. function:: FSTAT(UNIT, VALUES, STATUS)
  14
  15   ``FSTAT`` is identical to :ref:`STAT`, except that information about an
  16   already opened file is obtained.
  17
  18   :param UNIT:
  19     An open I/O unit number of type ``INTEGER``.
  20
  21   :param VALUES:
  22     The type shall be ``INTEGER(4), DIMENSION(13)``.
  23
  24   :param STATUS:
  25     (Optional) status flag of type ``INTEGER(4)``. Returns 0
  26     on success and a system specific error code otherwise.
  27
  28   Standard:
  29     GNU extension
  30
  31   Class:
  32     Subroutine, function
  33
  34   Syntax:
  35     .. code-block:: fortran
  36
  37       CALL FSTAT(UNIT, VALUES [, STATUS])
  38       STATUS = FSTAT(UNIT, VALUES)
  39
  40   Example:
  41     See :ref:`STAT` for an example.
  42
  43   See also:
  44     To stat a link:
  45     :ref:`LSTAT`
  46     To stat a file:
  47     :ref:`STAT`