gcc/fortran/doc/gfortran/intrinsic-procedures/null.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 .. _null:
   7
   8 NULL --- Function that returns an disassociated pointer
   9 *******************************************************
  10
  11 .. index:: NULL, pointer, status, pointer, disassociated
  12
  13 .. function:: NULL(MOLD)
  14
  15   Returns a disassociated pointer.
  16
  17   :param MOLD:
  18     (Optional) shall be a pointer of any association
  19     status and of any type.
  20
  21   :return:
  22     A disassociated pointer.
  23
  24   Standard:
  25     Fortran 95 and later
  26
  27   Class:
  28     Transformational function
  29
  30   Syntax:
  31     .. code-block:: fortran
  32
  33       PTR => NULL([MOLD])
  34
  35   Example:
  36     .. code-block:: fortran
  37
  38       REAL, POINTER, DIMENSION(:) :: VEC => NULL ()
  39
  40   See also:
  41     :ref:`ASSOCIATED`