|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer|
/Fp (Name .pch File)
Use this option with /YX, /Yc, or /Yu to provide a path name for a precompiled header instead of using the default path name. You can also use /Fp with /Yc to specify the use of a precompiled header file that differs from the /Yc filename argument and from the base name of the source file.
If you do not specify an extension as part of the path name, an extension of .pch is assumed. If you specify a directory without a file name, the default file name is VCx0.pch., where x is the major version of Visual C++ in use.
You can also use the /Fp option with the /Yu and /YX options.
To set this compiler option in the Visual Studio development environment
- Open the project's Property Pages dialog box. For details, see Setting Visual C++ Project Properties.
- Click the C/C++ folder.
- Click the Precompiled Headers property page.
- Modify the Precompiled Header File property.
To set this compiler option programmatically
The following command renames the precompiled header file created and used by /YX:
CL /YX /FpMYPCH.PCH PROG.CPP
If you want to create a precompiled header file for a debugging version of your program and you are compiling both header files and source code, you can specify a command such as:
CL /DDEBUG /Zi /Yc /FpDPROG.PCH PROG.CPP
The following command specifies the use of a precompiled header file named MYPCH.pch. The compiler assumes that the source code in PROG.cpp has been precompiled through MYAPP.h and that the precompiled code resides in MYPCH.pch. It uses the content of MYPCH.pch and compiles the rest of PROG.cpp to create an .obj file. The output of this example is a file named PROG.exe.
CL /YuMYAPP.H /FpMYPCH.PCH PROG.CPP