关于预编译头

 关于预编译头

一、什么是预编译头?

预编译头物理上与通常的的.obj文件是一样的，但编译入预编译头的.h,.c,.cpp文件在整个编译过程中，只编译一次，如预编译头所涉及的部分不发生改变的话，在随后的编译过程中此部分不重新进行编译。进而大大提高编译速度，并便于对头文件进行管理，也有助于杜绝重复包含问题。

二、什么时候使用预编译头?

当大多.c或.cpp文件都需要相同的头文件时。

当某些代码被大量重复使用时。

当导入某些不同库都有实现的函数，并产生混乱时。

三、预编译头所涉及的编译开关及使用方法(for msvc)

1、自动预编译：由编译器决定什么时候建立和使用预编译头。

编译参数：-YX。使用此参数缺省时建立以VCxy.pch命名的预编译头文件。其中x,y是vc的版本号。可以用-Fp指定pch文件的输出路径和文件名。

比如：cl –c –YX –Fp“precomp.pch” **将在当前目录下生成precomp.pch的预编译头文件。**代表源文件。

2、手动预编译：

    编译参数：

-Yc”预编译的头文件的名字” 此时缺省建立与头文件同名的预编译头文件。如要该为其他名字，可使用-Fp选项。

    比如：cl –c –Yc”precomp.h” ** 将建立precomp.pch的预编译头文件。

 

    -Yu” 预编译的头文件的名字”  表示在某个源文件时使用此预编译头，而不在进行重新编译。比如：

    cl –c –Yu”precomp.h” **

    注：相应预编译头必须在前面已建立过。

 

四、在makefile中简单的使用预编译技术

 

obj/i386/debug.obj: debug.c debug.h

        $(CC) –Yc”precomp.h” -Fo$@ debug.c

        

obj/i386/OperateReg.obj: OperateReg.c OperateReg.h

        $(CC) –Yu”precomp.h” -Fo$@ OperateReg.c

       

obj/i386/WaterMark.obj: WaterMark.c WaterMark.h

        $(CC) –Yu”precomp.h” -Fo$@ WaterMark.c 

以下同。

其中precomp.h为想预编译的头文件。

 

五、关于预编译头的一些复杂的使用方法

如：

cl -c -Yc"stuff.h" -Fplevel1.pch level1.cpp       -------------（1）
   
   

cl -c -Yu"stuff.h" -Fplevel1.pch -Yc level2.cpp   --------------（2）
   
   

level2.cpp的开始是这样的，其中 #pragma hdrstop 表示预编译结束，所以说代码也可以放入预编译头。
   
   

#include "stuff.h"
   
   

#include "morestuff.h"
   
   

#pragma hdrstop("level2.pch")
   
   

（1）       建立使用stuff.h 重命名为level1.pch的预编译头。
    
    

（2）       在从stuff.h建立的预编译头level1.pch的基础上，参考level2.cpp建立另一个预编译头level2.pch
    
    

此时的命名规则参见Yc无参数时的使用方法。
    
    

预编译头的其他使用细则请参考msdn。
    
    

附：
    
    

1、  预编译与guard宏
    
    

这是两个根本没有关系的概念，如果说非要找出相同的地方，那就是预编译头对控制重复包含也有一定的帮助。
    
    

#ifndef _PLOTBRUSH_
   
   

#define _PLOTBRUSH_
   
   

---
   
   

#endif  // _PLOTBRUSH_
   
   

这种guard宏是防止在同一个.c文件中把同一个.h文件包含两次。
    
    

即防止出现
    
    

#include <windows.h>
   
   

#include <windows.h>
   
   

的情况的。
    
    

而预编译头相当于在全局的角度，来控制那些部分仅被编译一次的问题。
    
    

而guard宏只对当前编译单元有效。在1.c中定义了_PLOTBRUSH_对2.c是根本没影响的。
    
    

2、  98ddk中build 时，使用build –Z将只编译有改变的源文件。-c 起清除目标文件夹的作用。
   
   

如有错漏请指正。
    
    

                                                               Written by 李智勇