pch-use

Lets you use a specific precompiled header file.

IDE Equivalent

None

Architectures

IA-32, Intel® 64, IA-64 architectures

Syntax

Linux and Mac OS X:

-pch-use {file | dir}

Windows:

None

Arguments

file

Is the name of the precompiled header file to use.

dir

Is the path where the file is located, including . The path must exist.

Default

OFF

The compiler does not create or use precompiled headers unless you tell it to do so.

Description

This option lets you use a specific precompiled header (PCH) file. It is supported for multiple source files when all source files use the same .pchi file.

This option cannot be used in the same compilation as the -pch-create option.

Caution iconCaution

Depending on how you organize the header files listed in your sources, this option may increase compile times. To learn how to optimize compile times using the PCH options, see "Precompiled Header Files" in the User's Guide.

Alternate Options

None

Example

Consider the following command line:

icpc -pch-use /pch/source32.pchi source.cpp

It produces the following output:

"source.cpp": using precompiled header file /pch/source32.pchi

See Also