C/C++ Compiler (cl.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
Using the hdrstop Pragma
                                             Up Contents Index Back
─────C/C++ Compiler─────────────────────────────────────────────────────────
 
     Syntax:  #pragma hdrstop[("filename")]
 
     If a C or a C++ file contains a hdrstop pragma, the compiler saves
     the state of the compilation up to the location of the pragma. The
     compiled state of any code that follows the pragma is not saved.
 
     The hdrstop pragma cannot occur inside a header file. It must
     occur in the source file at the file level; that is, it cannot
     occur within any data or function declaration or definition.
 
     Use <filename> to name the precompiled header file in which the
     compiled state is saved. The <filename> must be a string (enclose
     it in quotation marks) and it must be enclosed in parentheses. A
     space between hdrstop and <filename> is optional. Note that you
     can also use the /Fp option to name the precompiled header file.
     If <filename> is not specified, the resulting filename is given
     the base name of the source file with a .PCH extension.
     See: /Fp
 
     If no hdrstop pragma is specified, the compiler saves the state of
     the compilation through the end of the source file. As in the
     previous case, the name of the .PCH file is derived from the base
     name of the source file with a .PCH extension.
 
     The hdrstop pragma is ignored unless either /Yu or /Yc is specifed
     without a <filename>.
 
     See also: Use Precompiled Header (/Yu)
               Create a Precompiled Header (/Yc)
               Using Precompiled Headers in PWB
                                    -♦-