This documentation is archived and is not being maintained.

/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

  1. Open the project's Property Pages dialog box. For details, see Setting Visual C++ Project Properties.
  2. Click the C/C++ folder.
  3. Click the Precompiled Headers property page.
  4. Modify the Precompiled Header File property.

To set this compiler option programmatically

See PrecompiledHeaderFile Property.


The following command renames the precompiled header file created and used by /YX:


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:


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.


See Also

Output-File (/F) Options | Compiler Options | Setting Compiler Options | Precompiled Header Compiler Options | Specifying the Pathname