FPT and WinFPT Reference Manual - Command-line Commands

| SimCon Home | Reference Manual Home |


INCLUDE INPUT SEARCH PATH

Syntax:

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

Function:

Specifies a sequence of directories which are to be searched in turn for INCLUDE files. 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 are written as quoted strings.

If ADD TO INCLUDE INPUT SEARCH PATH is specified, the argument is 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 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"  -
   "\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 INCLUDE SEARCH PATH appends additional directories to the current search path. 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:

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

Example:

! WSYM.FSP - for aerodynamic sim with wind
%include search path: "/home/john/aerosim/work"  "/home/john/ilib"
aero.for
stab.for
%include search path: "/home/john/cntrl" "/home/john/work" -
   "/home/john/ilib"
gyro.for
accel.for
! end of WSYM.FSP

See also:

IGNORE DIRECTORIES IN INCLUDE STATEMENTS

INCLUDE INPUT DIRECTORY

PRIMARY INPUT SEARCH PATH


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