gcc/fortran/doc/gfortran/intrinsic-procedures/free.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 .. index:: FREE, pointer, cray
   7
   8 .. _free:
   9
  10 FREE --- Frees memory
  11 *********************
  12
  13 .. function:: FREE(PTR)
  14
  15   Frees memory previously allocated by ``MALLOC``. The ``FREE``
  16   intrinsic is an extension intended to be used with Cray pointers, and is
  17   provided in GNU Fortran to allow user to compile legacy code. For
  18   new code using Fortran 95 pointers, the memory de-allocation intrinsic is
  19   ``DEALLOCATE``.
  20
  21   :param PTR:
  22     The type shall be ``INTEGER``. It represents the
  23     location of the memory that should be de-allocated.
  24
  25   :return:
  26     None
  27
  28   Standard:
  29     GNU extension
  30
  31   Class:
  32     Subroutine
  33
  34   Syntax:
  35     .. code-block:: fortran
  36
  37       CALL FREE(PTR)
  38
  39   Example:
  40     See ``MALLOC`` for an example.
  41
  42   See also:
  43     :ref:`MALLOC`