头文件:
- 一般写类的声明(包括类里面的成员和方法的声明)、函数原型、#define常数等,但一般来说不写出具体的实现。
- 头文件应该以 .h 作为扩展名
- 头文件本身应该可以被编译
- 头文件需要通过宏来保证不被重复包含
在C++中,为了避免同一个文件被include多次,通常有两种方式:1
2
3#pragma once
// 声明、定义语句
或者1
2
3
4
5
6#ifndef __HEAD__
#define __HEAD__
// 声明、定义语句
#endif
在能够支持这两种方式的编译器上,二者并没有太大的区别,但是两者仍然还是有一些细微的区别。
#ifndef
#ifndef 的方式受 C/C++ 语言标准支持。它不光可以保证同一个文件不会被包含多次,也能保证内容完全相同的两个文件(或者代码片段)不会被不小心同时包含。
另外一个缺点就是该方式需要自定义宏名称,当项目很大时,宏名称有“撞车”的风险。可以依靠严格的命名方式来解决,如
<PROJECT>_<PATH>_<FILE>_H_由于编译器每次都需要打开头文件才能判定是否有重复定义,因此在编译大型项目时,ifndef会使得编译时间相对较长,因此一些编译器逐渐开始支持#pragma once的方式。
#pragma once
#pragma once 一般由编译器提供保证:同一个文件不会被包含多次。注意这里所说的“同一个文件”是指物理上的一个文件,而不是指内容相同的两个文件。优点是支持的编译器预处理期间可以很快扫描并识别,可以提高编译速度。同时不需要自定义宏名称,避免了“撞车”的风险。
对应的缺点就是如果某个头文件有多份拷贝,本方法不能保证他们不被重复包含。