|
Google 开源项目风格指南——中文版
Google C++ Style Guide
1. 头文件
1.1 前置声明
????????类似于函数的声明和定义，C++里类的声明和定义也是可以分开的。我们可以先声明而暂时不定义它，这种声明就称为类的前置声明。
????????注意：前置声明的类是不完全类型（incomplete type），我们只能定义指向该类型的指针或引用，或者声明（但不能定义）以不完全类型作为参数或者返回类型的函数。
1.2 #include的路径及顺序
????????您所依赖的符号 (symbols) 被哪些头文件所定义，您就应该包含（include）哪些头文件，前置声明?(forward declarations) 情况除外。比如您要用到?bar.h?中的某个符号, 哪怕您所包含的?foo.h?已经包含了?bar.h, 也照样得包含?bar.h, 除非?foo.h?有明确说明它会自动向您提供?bar.h?中的 symbol。不过，凡是 cc 文件所对应的「相关头文件」已经包含的，就不用再重复包含进其 cc 文件里面了，就像?foo.cc?只包含?foo.h?就够了，不用再管后者所包含的其它内容。
????????在?#include?中插入空行以分割相关头文件, C 库, C++ 库, 其他库的?.h?和本项目内的?.h?是个好习惯。
|