首页 > 代码库 > Google C++ style guide——头文件

Google C++ style guide——头文件

1.#define保护

使用#define防止头文件被多重包含。命名格式为:<PROJECT>_<PATH>_<FILE>_H_

例如,foo中的头文件foo/src/bar/baz.h

#ifndef FOO_BAR_BAZ_H_
#define FOO_BAR_BAZ_H_

...

#endif //FOO_BAR_BAZ_H_


2.头文件依赖

使用前置声明尽量减少.h文件中#include的数量。

头文件被更改时,需要重新编译。那些包含了该头文件的代码也需要重新编译,因此,我们应该实现尽可能少的在头文件中包含头文件。

前置声明可以明显的减少需要包含的头文件数量。假如你在一个头文件中需要用到类File,但不需要访问File的声明,则头文件只需前置声明class File。

在以下情况可以使用类Foo而无需访问类的定义。

1)将数据成员类型声明为Foo *或者Foo &;

2)参数、返回值类型为Foo的函数只是声明(不在头文件内定义实现);

3)静态数据成员的类型可以被声明为Foo(因为静态数据成员的定义在类定义之外)。

如果你的类是Foo的子类,或者含有类型为Foo的非静态数据成员,则必须为之包含头文件。

有时,使用指针成员替代对象成员的确更有意义。但是,这样的做法会降低代码可读性及执行效率。如果仅仅为了少包含头文件,还是不要替代比较好。

当然,.cc或者.cpp无论如何都需要所使用类的定义部分,自然也就会包含若干头文件。


3.内联函数

只有当函数只有10行甚至更少时才会将其定义为内联函数。

当函数被声明为内联函数之后,编译器可能会将其内联展开,无需按通常的函数调用机制调用内联函数。

优点:当函数体比较小的时候,内联该函数可以令目标代码更加高效。例如存取函数,以及其他一些比较短的关键执行函数。

缺点:滥用内联将导致程序变慢,内联有可能使目标代码量或增或建,这取决与被内联的函数的大小。内联较短小的存取函数通常会减少代码量,但内联一个很大的函数(如果编译器允许的话),将显著增加代码量。

在现在处理器上,由于更好的利用指令缓存,小巧的代码往往执行更快。

一个比较得当的处理规则是,不要内联超过10行的函数。对于析构函数应慎重对待,析构函数往往比其表面看起来要长,因为有一些隐式成员和基类析构函数(如果有的话)被调用。


虚函数和递归函数即使被声明为内联的,也不一定就是内联函数。通常,递归函数不应该被声明为内联的(递归调用堆栈的展开并不像循环那么简单,比如递归层数在编译时可能是未知的,大多数编译器都不支持内联递归函数)。析构函数内联的主要原因是其定义在类的定义中,为了方便抑或是对其行为给出文档。


4.-inl.h文件

复杂的内联函数的定义,应放在后缀名为-inl.h的头文件中。

在头文件中给出内联函数的定义,可令编译器将其在调用出内联展开。然后,实现代码应完全放到.cc文件中,我们不希望.h文件中出现太多实现代码,除非这样做在可读性和效率上有明显优势。

如果内联函数的定义比较短小、逻辑比较简单,其实现代码可以放在.h文件中。例如,存取函数的实现理所当然都放在类定义中。处于实现和调用的方便,较复杂的内联函数也可以放到.h文件中,如果你觉得这样会使头文件显得笨重,还可以将其分离到单独的-inl.h中。这样即把实现和类定义分离开来,当需要时包含实现所在的-inl.h即可。

同样的,-inl.h也是需要#define保护的。


5.函数参数顺序

定义函数事,参数顺序为:输入参数在前,输出参数在后。


6.将包含次序标准化可增强可读性、避免隐藏依赖,次序如下:C库、C++库、其他库的.h、项目内的.h。

相同目录下头文件按字母序是不错的选择。

Google C++ style guide——头文件