Yc

Tells the compiler to create a precompiled header file.

IDE Equivalent

Windows: Precompiled Headers > Precompiled Header File (VS 2010)

Precompiled Headers > Create-Use Precompiled Header / Create-Use PCH Through File (VS 2005/2008)

Linux: None

Mac OS X: None

Architectures

IA-32, Intel® 64 architectures

Syntax

Linux and Mac OS X:

None

Windows:

/Yc[filename]

Arguments

filename

Is the name of a C/C++ header file, which is included in the source file using an #include preprocessor directive.

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.

When filename is specified, the compiler creates a precompiled header file from the headers in the C/C++ program up to and including the C/C++ header specified.

If you do not specify filename, the compiler compiles all code up to the end of the source file, or to the point in the source file where a hdrstop occurs. The default name for the resulting file is the name of the source file with extension .pchi.

This option cannot be used in the same compilation as the /Yu option.

Alternate Options

Linux and Mac OS X: -pch-create

Windows: None

Example

If option /Fp is used, it names the PCH file. For example, consider the following command lines:

icl /c /Ycheader.h /Fpprecomp foo.cpp

icl /c /Yc /Fpprecomp foo.cpp

In both cases, the name of the PCH file is "precomp.pchi".

If the header file name is specified, the file name is based on the header file name. For example:

icl /c /Ycheader.h foo.cpp

In this case, the name of the PCH file is "header.pchi".

If no header file name is specified, the file name is based on the source file name. For example:

icl /c /Yc foo.cpp

In this case, the name of the PCH file is "foo.pchi".

Yc