10. 规则特例
总述
对于现有不符合既定编程风格的代码可以网开一面.
说明
10.2. Windows 代码
总述
Windows 程序员有自己的编程习惯, 主要源于 Windows 头文件和其它 Microsoft 代码. 我们希望任何人都可以顺利读懂你的代码, 所以针对所有平台的 C++ 编程只给出一个单独的指南.
说明
- 不要使用匈牙利命名法 (比如把整型变量命名成 ). 使用 Google 命名约定, 包括对源文件使用
.cc
扩展名. - 使用 Microsoft Visual C++ 进行编译时, 将警告级别设置为 3 或更高, 并将所有警告(warnings)当作错误(errors)处理.
- 不要使用
#pragma once
; 而应该使用 Google 的头文件保护规则. 头文件保护的路径应该相对于项目根目录 (Yang.Y 注: 如 , 参考 一节). 除非万不得已, 不要使用任何非标准的扩展, 如
#pragma
和declspec
. 使用declspec(dllimport)
和__declspec(dllexport)
是允许的, 但必须通过宏来使用, 比如DLLIMPORT
和 , 这样其他人在分享使用这些代码时可以很容易地禁用这些扩展.
然而, 在 Windows 上仍然有一些我们偶尔需要违反的规则:- 虽然代码中不应该使用异常, 但是在 ATL 和部分 STL(包括 Visual C++ 的 STL) 中异常被广泛使用. 使用 ATL 时, 应定义
_ATL_NO_EXCEPTIONS
以禁用异常. 你需要研究一下是否能够禁用 STL 的异常, 如果无法禁用, 可以启用编译器异常. (注意这只是为了编译 STL, 自己的代码里仍然不应当包含异常处理). - 通常为了利用头文件预编译, 每个每个源文件的开头都会包含一个名为
StdAfx.h
或precompile.h
的文件. 为了使代码方便与其他项目共享, 请避免显式包含此文件 (除了在precompile.cc
中), 使用/FI
编译器选项以自动包含该文件. - 资源头文件通常命名为
resource.h
且只包含宏, 这一文件不需要遵守本风格指南.