Imports text from a specified file.
Syntax
INCLUDE character-literal-constant |
- character-literal-constant
is the name of the file to include.
Description
The keyword INCLUDE
and character-literal-constant form an
INCLUDE line,
which is used to insert text into a program prior to compilation.
The inserted text replaces the INCLUDE
line; the INCLUDE
line should therefore appear in your program where you want the
inserted text. When the end of an included file is reached, the
compiler continues processing with the line following the INCLUDE
line.
character-literal-constant can
be either a file name or a device name. It must not have a kind
parameter that is a named constant.
The INCLUDE
line must appear on one line with no other text except possibly
a trailing comment. It should not have a statement label. Thus,
you cannot branch to it, and it cannot be an action statement that
is part of a Fortran 90 IF
statement. You cannot use the ";"
operator to add a second INCLUDE
line, nor can you use the "&"
operator to continue it over another line.
The compiler searches directories for the named include files
in the following order:
The current source directory
Directories specified by the -I
compile-line option, in the order specified
The current working directory
The directory /usr/include
INCLUDE
lines can be nested to a maximum of ten levels. However, they must
be nested nonrecursively. That is, inserted text must not specify
an INCLUDE line
that was encountered at an earlier level of nesting.
Line numbering within the listing of an included file begins
at 1. When the included file listing ends, the include level decreases
appropriately, and the previous line numbering resumes.
Examples
INCLUDE "my_common_blocks"
INCLUDE "/my_stuff/declarations.h" |
Related concepts
For related information, see the following:
Printable version
