fpt Reference: INPUT SEARCH PATH

fpt and WinFPT Reference Manual - Command-line Commands

| SimCon Home | Ref Manual Home |

INPUT SEARCH PATH

Syntax:

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

Function:

Specifies a sequence of directories which are to be searched in turn for input files. The search path is used:

for all primary files where the file name does not include a directory specification;
for INCLUDE files when the INCLUDE statement does not contain a directory specification;
for INCLUDE files when the command IGNORE DIRECTORIES IN INCLUDE STATEMENTS has been made.

The directory specifications are written as quoted strings.

If ADD TO INPUT SEARCH PATH is specified, the arguments are added to the existing path (if any). Otherwise the new path replaces the old path.

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 search path specifications.

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

%input path: "\john\aerosim\include" - "\john\ilib" aero gusts

if aero.for 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 and then, if no matching file is found, in \john\ilib.

Note, in the example above, that the list of directories may extend over two or more lines. The command continuation character must be used when this occurs.

The command ADD TO SEARCH PATH appends additional directories to the current search path. The command INPUT DIRECTORY specifies a single input directory. The commands PRIMARY INPUT SEARCH PATH and INCLUDE INPUT SEARCH PATH specify separate search paths for primary and for INCLUDE 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

The current directory (Note that defaults may be changed in the configuration file).

Examples

! chequers.f %input search path: "/usr/people/john/work" > "/usr/people/geoff/cheq" > "/usr/bin/graphlib/source" move.f crown.f timecount.f eval.f refute.f games.bda ! end chequers.fsp

Note that in this example the command continuation character has been changed to ">".