gcc/fortran/doc/gfortran/intrinsic-procedures/newline.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:: NEW_LINE, newline, output, newline
   7
   8 .. _new_line:
   9
  10 NEW_LINE --- New line character
  11 *******************************
  12
  13 .. function:: NEW_LINE(C)
  14
  15   ``NEW_LINE(C)`` returns the new-line character.
  16
  17   :param C:
  18     The argument shall be a scalar or array of the
  19     type ``CHARACTER``.
  20
  21   :return:
  22     Returns a :samp:`{CHARACTER}` scalar of length one with the new-line character of
  23     the same kind as parameter :samp:`{C}`.
  24
  25   Standard:
  26     Fortran 2003 and later
  27
  28   Class:
  29     Inquiry function
  30
  31   Syntax:
  32     .. code-block:: fortran
  33
  34       RESULT = NEW_LINE(C)
  35
  36   Example:
  37     .. code-block:: fortran
  38
  39       program newline
  40         implicit none
  41         write(*,'(A)') 'This is record 1.'//NEW_LINE('A')//'This is record 2.'
  42       end program newline