Intel® C++ Compiler Classic Developer Guide and Reference

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

pch-create

Tells the compiler to create a precompiled header file.

Syntax

Linux and macOS:

-pch-create filename

Windows:

None

Arguments

filename

Is the name for the precompiled header file. 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 create a precompiled header (PCH) file. It is supported only for single source file compilations.

Note that the .pchi extension is not automatically appended to the file name.

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

On Windows* systems, option -pch-create is equivalent to the /Yc option.

IDE Equivalent

None

Alternate Options

Linux and macOS: None

Windows: /Yc

Example

Consider the following command line:

icpc -pch-create /pch/foo.pchi foo.cpp

This creates the precompiled header file "/pch/foo.pchi".

See Also