/Yu(使用预编译的头文件)
指示编译器使用当前编译中现有的预编译头 (.pch) 文件。
/Yu[filename]
参数
- filename
头文件的名称,它包含在使用 #include 预处理器指令的源文件中。
备注
对于创建预编译头的 /Yc 选项和任何随后指示使用预编译头的 /Yu 选项,包含文件的名称必须相同。
对于 /Yc,filename 指定预编译停止的位置;编译器预编译直到 filename 的所有代码,并使用包含文件的基名称和 .pch 扩展名对得到的预编译头进行命名。
该 .pch 文件必须是使用 /Yc 创建的。
编译器将所有在 .h 文件之前出现的代码视为已经过预编译。它刚好跳到与 .h 文件关联的 #include 指令之外,使用 .pch 文件中包含的代码,然后编译 filename 之后的所有代码。
在命令行上,/Yu 和 filename 之间不允许存在空格。
如果指定 /Yu 选项但不带文件名,则源程序必须包含指定预编译头(.pch 文件)的文件名的 #pragma hdrstop 杂注。在这种情况下,编译器将使用由 /Fp(命名 .Pch 文件) 命名的预编译头(.pch 文件)。编译器跳到该杂注所在的位置,从由杂注指定的预编译头文件还原编译状态,然后只编译杂注后面的代码。如果 #pragma hdrstop 没有指定文件名,编译器将查找其名称从扩展名为 .pch 的源文件的基名称派生的文件。还可以使用 /Fp 选项指定不同的 .pch 文件。
如果指定 /Yu 选项但不带文件名,且未能指定 hdrstop 杂注,则生成错误信息,且编译不成功。
如果 /Ycfilename 和 /Yufilename 选项出现在同一命令行上,并且引用同一文件名,则 /Ycfilename 优先,对直到命名文件(包含该文件)的所有代码进行预编译。此功能简化了生成文件的编写。
由于 .pch 文件包含的信息涉及计算机环境以及程序的内存地址,因此,只应在创建 pch 文件的计算机上使用该文件。
有关预编译头的更多信息,请参见:
在 Visual Studio 开发环境中设置此编译器选项
在项目中的 .cpp 文件中指定 /Yc(创建预编译的头文件)。
打开项目的**“属性页”**对话框。有关详细信息,请参见如何:打开项目属性页。
单击**“C/C++”**文件夹。
单击**“预编译头”**属性页。
修改**“通过文件创建/使用 PCH”属性或“创建/使用预编译头”**属性。
以编程方式设置此编译器选项
示例
如果下列代码:
#include <afxwin.h> // Include header for class library
#include "resource.h" // Include resource definitions
#include "myapp.h" // Include information specific to this app
...
使用命令行 CL /YuMYAPP.H PROG.CPP 进行编译,则编译器不处理这三个 include 语句,但使用 MYAPP.pch 中的预编译代码,从而节省了用于预处理所有这三个文件(以及它们可能包含的任何文件)的时间。
可以将 /Fp(命名 .Pch 文件) 选项与 /Yu 选项一起使用,以指定 .pch 文件的名称(如果该名称不同于 /Yc 的文件名参数或源文件的基名称),如下所示:
CL /YuMYAPP.H /FpMYPCH.pch PROG.CPP
此命令指定名为 MYPCH.pch 的预编译头文件。编译器使用其内容还原所有头文件(一直到 MYAPP.h 并包含该文件)的预编译状态。然后编译器编译在 MYAPP.h 的 include 语句之后出现的代码。