HP Fortran Programmer's Reference (September 2007)

HP Fortran statements

INCLUDE

Chapter 10 373

INCLUDE

Imports text from a speciﬁed ﬁle.

Syntax

INCLUDE

character-literal-constant

is the name of the ﬁle 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 ﬁle is reached, the compiler continues processing with the

line following the INCLUDE line.

character-literal-constant

can be either a ﬁle 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 ﬁles in the following order:

1. The current source directory

2. Directories speciﬁed by the -I compile-line option, in the order speciﬁed

3. The current working directory

4. 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 ﬁle begins at 1. When the included ﬁle

listing ends, the include level decreases appropriately, and the previous line numbering

resumes.