Export (0) Print
Expand All

/Fp (Name .pch File)

/Fppathname

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.

Examples

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

See Also

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

Show:
© 2014 Microsoft