(译自:http://geosoft.no/development/cppstyle.html 中的3.1节,稍有改编)
elmar 翻译
下述惯例中的用词“必须”指必须被遵循,“应该”指强烈推荐
一般的命名惯例
3. 表示类型(type)的名字必须大小写结合并以大写字母开头
4. 变量名字必须大小写结合并以小写字母开头
5. 命名的常量(包括枚举值)必须都是大写字母,单词间用下滑线隔开
6. 表示方法或函数的名字必须是大小写结合的动词并以小写字母开头
7. 表示名字空间的名字应该全部小写
8. 表示模板类型的名字应该是一个大写的字母
template<class T> ...
template<class C, class D> ...
9. 缩略词用于名字时不能再全部大写
exportHtmlSource(); // NOT: exportHTMLSource();
openDvdPlayer(); // NOT: openDVDPlayer();
10.全局变量应该带上::操作符前缀
11.类的私有变量应该加后缀_
class SomeClass {
private:
int length_;
};
12.泛指的变量应该用与和他们类型相同的名字
void setTopic (Topic *topic) // NOT: void setTopic (Topic *value)
// NOT: void setTopic (Topic *aTopic)
// NOT: void setTopic (Topic *x)
void connect (Database *database) // NOT: void connect (Database *db)
// NOT: void connect (Database *oracleDB)
非泛指的变量担任一个角色。这些变量经常可以结合用途和类型来命名:
Point startingPoint, centerPoint;
Name loginName;
13.所有的名字都应用英语命名
14.作用域大的变量应该用一个长的名字,作用域小的变量可以用短的名字。
15.对象的方法名应避免加入对象名,因为对象名已被隐含
line.getLength(); // NOT: line.getLineLength();