INCLUDE - include a source file.

Usage:

$include(filename)

Where:

filename
is the name of the file to be included. "filename" cannot exceed 80 characters.

Description:

The system macro INCLUDE is used to insert source files in the program at compile time. Upon encountering an INCLUDE, MAP saves the state of the current file and the named file is opened and rewound. Successive input comes from the new file until end of file is encountered. At that time, the new file is closed and reading continues from the old file.

Included files may be nested, but recursive includes are not allowed. The user is cautioned to beware of AFT name conflicts, and to use altnames if required.

The current implementation does not save the remainder of the source line on which the "$include" appeared, so text to the right of an INCLUDE is ignored. This also applies to the expansion of macros -- an INCLUDE causes all macros in progress to be terminated immediately.

Copyright © 1996, Thinkage Ltd.