fpt Reference: Compare Sub-programs

fpt and WinFPT Reference Manual - Command-line Commands

| SimCon Home | Ref Manual Home |

COMPARE SUB-PROGRAMS

Syntax:

COMPARE SUB-PROGRAMS <symbol> <symbol>

Function:

fpt compares the named sub-programs. The sub-program names may be enclosed in quotation marks, and are required to be enclosed in quotation marks if they contain exotic characters such as ':' (Please see the command ACCEPT CHARACTER for the non-standard characters which occur in identifiers in some language extensions).

When the sub-programs are compared, fpt reports whether the:

header comments match. The header comments are the comments which precede or follow the sub-program statement and precede the first declaration or executable statement;
comments match in the body of the sub-program;
declarations match. Note that two sub-programs may be functionally identical even though variables are declared explicitly in one and are implicitly typed in the other;
names used for variables and labels match. fpt recognises that two sub-programs may be functionally identical even though different names are used for variables which occupy the same COMMON block locations or which serve the same purpose. If the names and labels do not match but the code is functionally equivalent, a table of the corresponding names is printed;
data statements match;
executable code matches, at least in function. If the executable code does not match, fpt prints the first line of each routine where a difference is detected. If the token which does not match is a symbol, the symbol attributes are displayed.

Where to Use this Command

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

Examples

fpt is run interactively to compare sub-programs:

FPT> comp sub-p indata getdata Comparing sub-programs ---------------------- INDATA line: 28 file: D:\JOHN\FPT\FPTTEST\INDATA.FOR GETDATA line: 33 file: D:\JOHN\FPT\FPTTEST\GETDATA.FOR Sub-programs differ: ****** INDATA line: 3 DO WHILE (I .LT. NDATA) ****** GETDATA line: 2 I=1 ****** FPT> FPT> comp sub-prog simplx simplex Comparing sub-programs ---------------------- SIMPLX line: 7 file: D:\JOHN\FPT\FPTTEST\SIMPLX.FOR SIMPLEX line: 12 file: G:\OPTIM\SOURCE\SIMPLEX.FOR Headers differ *** Comments match Declarations match Names match DATA statements match Executable code is functionally identical