fpt Reference: CHECK USAGE

fpt and WinFPT Reference Manual - Command-line Commands

| SimCon Home | Ref Manual Home |

CHECK USAGE

Syntax:

[DO NOT] CHECK [SYMBOL] USAGE

Function:

fpt checks for objects which are:

read but never written (reported as errors);
written to but never read (reported as warnings);
declared but never used (reported as notes).

The following assumptions are made in the check:

An object is considered to be read or to be written if it is read or written explicitly in the code, or if any part of any object equivalenced to it is read or written. Implied equivalence, where the object occupies the same COMMON block location as a different object in a different sub-program is taken into account.
An array, a string, a record or an object of a derived type is considered to be read or to be written if any element or component of the object is read or written. The current version of fpt does not track read or write access to individual array elements, fields or type components.

Unused Fortran parameters may be excluded from the check by the command NO WARNINGS FOR UNUSED PARAMETERS.

Where to Use this Command

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

Default

No check is made by default (Note that defaults may be changed in the configuration file).

Examples

FPT> check usage Symbol Usage Check ================== Objects which are read but never written to ------------------------------------------- Name Sub-prog/Struct Use/COMMON Address Type Size Bounds ---- --------------- ---------- ------- ---- ---- ------ J SUMCOLS Local INTEGER *4 df --------------------------------------------------------------- Symbol Usage Check Total number of objects read but never written (Errors): 1 --------------------------------------------------------------- No objects are written to but never read No objects are declared but unused.