自用的规范,参考自Google、华为与微软。
————————————————————————————
正确使用头文件可令代码在可读性、文件大小和性能上大为改观。
-
#define的保护
所有头文件都应该使用#define防止头文件被多重包含,命名格式为:<PROJECT><PATH><FILE>_H。
为保证唯一性,头文件的命名应基于所在项目源代码树的全路径。例如,项目slam中的头文件slam/kalman/test/test.h按如下方式保护:#ifndef SLAM_KALMAN_TEST_TEST_H_ #define SLAM_KALMAN_TEST_TEST_H_ ... #endif
注意事项:
1)不要在宏最前面加上下划线,因为这种做法为ANSI C等使用,在有些静态检查工具中,若全局可见的标识符以“_”开头会给出警告;
2)保护符使用使用唯一名称;
3)不要在受保护部分的前后放置代码或者注释。 - (未完待续)