fpt and WinFPT Reference Manual - Command-line Commands

| SimCon Home | Ref Manual Home |

ADD TO INCLUDE INPUT SEARCH PATH

Syntax:

ADD TO INCLUDE [INPUT] [SEARCH] PATH [:] <string>

Function:

The command INCLUDE INPUT SEARCH PATH specifies a sequence of directories which are to be searched in turn for INCLUDE files. The command ADD TO INCLUDE INPUT SEARCH PATH is used to append additional directories to the current path. The search path is used:

  1. when the INCLUDE statement does not contain a directory specification;
  2. when the command IGNORE DIRECTORIES IN INCLUDE STATEMENTS has been made.

The directory specifications must be written as quoted strings.

This command is position sensitive in the command line or specification file in which it is written. It applies to the files which follow it, and a list of Fortran files may contain several different INCLUDE search path specifications.

The INCLUDE file search path is inherited by nested INCLUDE files. Thus, for example, in the specification (written in an FSP file):

%include input path: "\john\aerosim\include" %add to include path "\john\ilib" - "\john\work" aero.f gusts.f

if aero.f contains the INCLUDE statement:

INCLUDE 'aerotab.inc'

and aerotab.inc in turn contains the statement:

INCLUDE 'wind.inc'

then wind.inc and aerotab.inc will both be sought first in \john\aerosim\include, then in \john\ilib and finally, if no matching file is found, in \john\work.

If the list of directories extends over two or more lines the command continuation character must be used, as in the example above.

The command INCLUDE INPUT DIRECTORY specifies a single input directory for INCLUDE files. The command PRIMARY INPUT DIRECTORY specifies the input directory for primary files. The command PRIMARY INPUT SEARCH PATH specifies a sequence of directories which will be searched in turn for primary files.

Where to Use this Command

Operating system command line Yes
Configuration file, config.fsp Yes
Specification (fsp) files, *.fsp Yes
Interactively, to FPT> prompt No
Interactive command files No
Embedded in the Fortran code No

Default

By default, files are sought in the current directory (Note that defaults may be changed in the configuration file).

See also:

IGNORE DIRECTORIES IN INCLUDE STATEMENTS

INCLUDE INPUT DIRECTORY

INCLUDE INPUT SEARCH PATH

PRIMARY INPUT SEARCH PATH

Copyright ©1995 to 2018 Software Validation Ltd. All rights reserved.