c++程序中的命名惯例

来源:互联网 发布:xml解析 java 编辑:程序博客网 时间:2024/04/29 22:31

(译自:http://geosoft.no/development/cppstyle.html 中的3.1节,稍有改编)

elmar 翻译

下述惯例中的用词“必须”指必须被遵循,“应该”指强烈推荐

一般的命名惯例

3. 表示类型(type)的名字必须大小写结合并以大写字母开头(elmar注:例如类的名字)
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(); 

原创粉丝点击