Intel® C++ Compiler Classic Developer Guide and Reference

ID 767249
Date 7/13/2023
Public
Document Table of Contents

pch-use

Tells the compiler to use a precompiled header file.

Syntax

Linux and macOS:

-pch-use filename

Windows:

None

Arguments

filename

Is the name of the precompiled header file to use. A space must appear before the file name. It can include a path.

Default

OFF

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

Description

This option tells the compiler to use a 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.

To learn how to optimize compile times using the PCH options, see "Using Precompiled Header Files" in the User's Guide.

On Windows* systems, option -pch-use is equivalent to the /Yu option.

IDE Equivalent

None

Alternate Options

Linux and macOS: None

Windows: /Yu

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