6.1. 通用命名规则

如何命名:

尽可能给出描述性的名称. 不要节约行空间, 让别人很快理解你的代码更重要. 好的命名风格:

int num_errors;                  // Good.int num_completed_connections;   // Good.

糟糕的命名使用含糊的缩写或随意的字符:

int n;                           // Bad - meaningless.int nerr;                        // Bad - ambiguous abbreviation.int n_comp_conns;                // Bad - ambiguous abbreviation.

类型和变量名一般为名词: 如 FileOpener, num_errors.

函数名通常是指令性的 (确切的说它们应该是命令), 如 OpenFile(), set_num_errors(). 取值函数是个特例 (在 函数命名 处详细阐述), 函数名和它要取值的变量同名.

缩写:

除非该缩写在其它地方都非常普遍, 否则不要使用. 例如:

// Good// These show proper names with no abbreviations.int num_dns_connections;  // 大部分人都知道 "DNS" 是啥意思.int price_count_reader;   // OK, price count. 有意义.

Warning

// Bad!// Abbreviations can be confusing or ambiguous outside a small group.int wgc_connections;  // Only your group knows what this stands for.int pc_reader;        // Lots of things can be abbreviated "pc".

永远不要用省略字母的缩写:

int error_count;  // Good.int error_cnt;    // Bad.

6.2. 文件命名

可接受的文件命名:

my_useful_class.ccmy-useful-class.ccmyusefulclass.cc

C++ 文件要以 .cc 结尾, 头文件以 .h 结尾.

不要使用已经存在于 /usr/include 下的文件名 (yospaly 注: 即编译器搜索系统头文件的路径), 如 db.h.

通常应尽量让文件名更加明确. http_server_logs.h 就比 logs.h 要好. 定义类时文件名一般成对出现, 如 foo_bar.h 和 foo_bar.cc, 对应于类 FooBar.

内联函数必须放在 .h 文件中. 如果内联函数比较短, 就直接放在 .h 中. 如果代码比较长, 可以放到以 -inl.h 结尾的文件中. 对于包含大量内联代码的类, 可以使用三个文件:

url_table.h      // The class declaration.url_table.cc     // The class definition.url_table-inl.h  // Inline functions that include lots of code.

参考 -inl.h 文件 一节.

6.3. 类型命名

所有类型命名 —— 类, 结构体, 类型定义 (typedef), 枚举 —— 均使用相同约定. 例如:

// classes and structsclass UrlTable { ...class UrlTableTester { ...struct UrlTableProperties { ...// typedefstypedef hash_map<UrlTableProperties *, string> PropertiesMap;// enumsenum UrlTableErrors { ...

6.4. 变量命名

my_exciting_local_variablemy_exciting_member_variable_

普通变量命名:

举例:

string table_name;  // OK - uses underscore.string tablename;   // OK - all lowercase.

Warning

string tableName;   // Bad - mixed case.

结构体变量:

结构体的数据成员可以和普通变量一样, 不用像类那样接下划线:

struct UrlTableProperties {    string name;    int num_entries;}

结构体与类的讨论参考 结构体 vs. 类 一节.

全局变量:

对全局变量没有特别要求, 少用就好, 但如果你要用, 可以用 g_ 或其它标志作为前缀, 以便更好的区分局部变量.

6.5. 常量命名

所有编译时常量, 无论是局部的, 全局的还是类中的, 和其他变量稍微区别一下. k 后接大写字母开头的单词::

const int kDaysInAWeek = 7;

6.6. 函数命名

常规函数:

函数名的每个单词首字母大写, 没有下划线:（我选择第一个单词首字母小写，以区分类）

AddTableEntry()DeleteUrl()

取值和设值函数:

取值和设值函数要与存取的变量名匹配. 这儿摘录一个类, num_entries_ 是该类的实例变量:

class MyClass {    public:        ...        int num_entries() const { return num_entries_; }        void set_num_entries(int num_entries) { num_entries_ = num_entries; }    private:        int num_entries_;};

其它非常短小的内联函数名也可以用小写字母, 例如. 如果你在循环中调用这样的函数甚至都不用缓存其返回值, 小写命名就可以接受.

6.7. 名字空间命名

关于名字空间的讨论和如何命名, 参考 名字空间 一节.

6.8. 枚举命名

单独的枚举值应该优先采用 常量 的命名方式. 但 宏 方式的命名也可以接受. 枚举名 UrlTableErrors (以及 AlternateUrlTableErrors) 是类型, 所以要用大小写混合的方式.

enum UrlTableErrors {    kOK = 0,    kErrorOutOfMemory,    kErrorMalformedInput,};enum AlternateUrlTableErrors {    OK = 0,    OUT_OF_MEMORY = 1,    MALFORMED_INPUT = 2,};

2009 年 1 月之前, 我们一直建议采用 宏 的方式命名枚举值. 由于枚举值和宏之间的命名冲突, 直接导致了很多问题. 由此, 这里改为优先选择常量风格的命名方式. 新代码应该尽可能优先使用常量风格. 但是老代码没必要切换到常量风格, 除非宏风格确实会产生编译期问题.

6.9. 宏命名

参考 预处理宏 <preprocessor-macros>; 通常 不应该 使用宏. 如果不得不用, 其命名像枚举命名一样全部大写, 使用下划线:

#define ROUND(x) ...#define PI_ROUNDED 3.0

6.10. 命名规则的特例

bigopen():

函数名, 参照 open() 的形式

uint:

typedef

bigpos:

struct 或 class, 参照 pos 的形式

sparse_hash_map:

STL 相似实体; 参照 STL 命名约定

LONGLONG_MAX:

常量, 如同 INT_MAX