INCLUDE - obtain source code from another file.

When the preprocessing facilities find a directive of the form

#include "filename"
the line is replaced by the entire contents of the specified file. For example,
#include "xxx"
is replaced by the contents of a file named xxx. The implementation searches for this file beginning in the directory that contains the original source file. If the file is not found there, the search continues through any directories named in Include= options on the compiler command line, then through a sequence of standard "include" directories under C_G8_SS/8CL3.3/INCLUDE.

If the directive takes the form

#include <filename>
as in
#include <stdio.h>
the implementation immediately searches through any directories named in StandardInclude= options on the compiler command line, then through the standard include directories. A file specified in this way (inside angle brackets) is called a header file.

It is valid to have a directive of the form

#include manifest
provided that the defined meaning of the manifest has one of the two previous forms of #include. For example, you could have
          #define FILENAME "myfile"
          #include FILENAME
Similarly, you may write
          #include macro(arg,arg,...)
if the final result has one of the two accepted forms of the #include directive.

A file that is obtained via #include may itself contain #include directives. In this way, #include directives may be nested.

The last line in an included file must end in a new-line.

Copyright (c) 1995, Thinkage Ltd.