C++ Compiler Precompiled Headers
Go Up to C++ Compiler
Project > Options > C++ Compiler > Precompiled headers
Use this dialog box to set C++ compiler precompiled headers options.
You might also want to read about and use the Precompiled Header Wizard.
Options | Description |
---|---|
Target, Apply, Save |
See Target Options. |
Common items |
Precompiled Headers Options | Description | Compiler support | ||||||
---|---|---|---|---|---|---|---|---|
bcc32 | bcc32c | bcc64 | bccosx | bcciosarm | bcciosarm64 | bccaarm | ||
Cache precompiled headers |
The compiler caches the precompiled headers it generates. This is useful when you are precompiling more than one header file. Default = False |
![]() |
![]() |
|||||
Enable smart cached precompiled headers |
The compiler smart-caches the precompiled headers it generates (smart-caching uses less memory than the regular caching option -Hc). Caching header files in memory is useful when you are precompiling more than one header file. Default = True |
![]() |
![]() |
|||||
External type files |
The compiler generates a debug type file or files that contain debugging type information for all the symbols contained in the precompiled headers. The files end with the .#xx extension, where xx is 00 for the first file generated and is incremented for each additional type-information file required. Using this option dramatically decreases the size of your .OBJ files, since debug type information is centralized and is not duplicated in each .OBJ file. Default = True |
![]() |
![]() |
|||||
Include contents of |
Includes the contents of the specified header file or files. Check the Inherit values from parent configuration(s) box to act as if the immediate ancestor files are merged into this list of files, though this list is not changed. The |
![]() |
![]() |
|||||
Inject precompiled header file |
Includes the contents of the single header file that you specify, and then instructs the compiler to stop precompiling at the end of that header each time the compiler is invoked. Is equivalent to adding the following directives at the beginning of each .cpp file: #include "myfile.h" #pragma hdrstop |
![]() |
![]() |
|||||
PCH Filename |
Specify the name of your precompiled header file. The compiler sets the name of the precompiled header to the specified filename. When this option is set, the compilers generate and use the precompiled header file that you specify. WARNING: If you import a project from BDS2006, the project's PCH file location is not imported due to Windows Vista compatibility since Vista restricts where users may place files. The |
![]() |
![]() |
|||||
PCH Usage Determines whether or not to use a precompiled header file. See Precompiled Headers Overview. |
Select from the following values:
|
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Replace header name(s): |
Replaces header name from name1 to name2. The |
![]() |
![]() |
|||||
Stop precompiling after |
Terminates compiling the precompiled header after processing the specified file. You can use this option to reduce the disk space required for precompiled headers. When you use this option, the file you specify must be included from a source file for the compiler to generate a precompiled header file. You can also use #pragma hdrstop within your .CPP files to specify when to stop the generation of precompiled headers. You cannot specify a header file that is included from another header file. For example, you cannot list a header included by windows.h, because this would cause the precompiled header file to be closed before the compilation of windows.h was completed. The |
![]() |
![]() |
See Also
- Precompiled Headers Overview
- C++ (Shared Options)
- BCC32.EXE, the C++ 32-bit Command-Line Compiler
- BCC32C
- BCC64.EXE, the C++ 64-bit Windows Compiler
- BCCOSX.EXE, the C++ Compiler for OS X
- BCCIOSARM.EXE, the C++ Compiler for the 32-bit iOS Device
- BCCIOSARM64.EXE, the C++ Compiler for the 64-bit iOS Device
- BCCAARM.EXE, the C++ Compiler for Android