# 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".

Parent topic: Output, Debug, and Precompiled Header (PCH) Options

## See Also

pch-use compiler option