1 # C语言不纠结 2 file.h & file.c 3 # C++ Group.1(注意C是大写) 4 file.h & file.C 5 # C++ Group.2 6 file.hh & file.cc 7 # C++ Group.3 8 file.hpp & file.cpp 9 # C++ Group.4 10 file.hxx & file.cxx
1 # Teddy项目UserLog文件为例: 2 # Group.1 3 UserLog.c & TedUserLog.c 4 # Group.2 5 userlog.c & teduserlog.c 6 # Group.3 7 userlog.c & ted_userlog.c 8 # Group.4 9 user_log.c & ted_user_log.c 10 # Group.5 11 user-log.c & ted-user-log.c
1 /* 2 ** 基本数据类型的重定义,小写比首字母大写更有利于延长Shift寿命, 3 ** 但也更容易产生命名冲突。 4 */ 5 typedef unsigned char byte; 6 typedef unsigned char byte_t; 7 typedef unsigned char Byte; 8 typedef unsigned char Byte_t; 9 10 /* 11 ** 类与结构体常见的风格是采用PascalCase,不推荐使用camelCase 12 ** 这种怪异的风格。 13 */ 14 class HashTable { ... 15 class hash_table { ... 16 struct FileInfo { ... 17 struct file_info { ... 18 19 /* C语言常见到的风格还有结构体名称加‘_t‘后缀 */ 20 struct fileinfo_t { ... 21 struct FileInfo_t { ... 22 23 /* 枚举命名常见PascalCase风格 */ 24 enum FileFlags { ... 25 enum file_flags { ...
1 /* 一般使用项目名称,风格看喜好。 */ 2 namespace my_project { ... 3 namespace MyProject { ...
tip.1:确保命名空间不会和常用的库冲突;
1 /* 2 ** 在函数和变量命名风格上PascalCase,camelCase, 3 ** snake_case三足鼎立,选择凭喜好。 4 */ 5 void FunctionName(void) { ... 6 void functionName(void) { ... 7 void function_name(void) { ... 8 9 long VarName; 10 long varName; 11 long var_name; 12 13 /* 14 ** tip.1:snake_case在名称比较长时可读性较好; 15 */ 16 long variable_names_in_snake_case; 17 long VariableNamesInPascalCase; 18 long variableNamesInCamelCase; 19 20 /* 21 ** tip.2:PascalCase和camelCase在函数中的区分度较好, 22 ** 在快速扫描代码逻辑的时候不易被其它符号所干扰。 23 */ 24 long FabonacciFunction(long rabbitNums) 25 { 26 if (rabbitNums < 2) { 27 return rabbitNums; 28 } 29 long resultOne = FabonacciFunction(rabbitNums - 1); 30 long resultTwo = FabonacciFunction(rabbitNums - 2); 31 return resultOne + resultTwo; 32 } 33 34 long fabonacci_function(long rabbit_nums) 35 { 36 if (rabbit_nums < 2) { 37 return rabbit_nums; 38 } 39 long result_one = fabonacci_function(rabbit_nums - 1); 40 long result_two = fabonacci_function(rabbit_nums - 2); 41 return result_one + result_two; 42 }
tip.3:如果类需要兼容标准库迭代器或是要支持range for,begin()和end()函数会破坏PascalCase风格的一致性;
1 /* 2 ** 类成员变量和全局变量的命名风格和局部变量的命名风格 3 ** 并没有更多的区别。唯一的问题是,是否要加前缀或后缀 4 ** 以方便和局部变量区分开来。 5 */ 6 class UserInfo { 7 ... 8 private: 9 std::string user_name_; /* Google style */ 10 std::string m_userName; /* Hungarian notation */ 11 /* 不推荐前缀‘_‘的风格,可能会和标准库命名冲突 */ 12 }; 13 14 /* 全局变量要少用,推荐加前缀用于区分 */ 15 extern "C" long g_commonCount;
tip.1:在有IDE提示时,前缀"m_"的类成员变量能够很快被找到,如果不喜欢这种风格,"this->"同样也很便利;
1 /* 2 ** 常量和枚举值的命名风格建议和局部变量的命名风格区分开, 3 ** 常见的有全字母大写加‘_‘的风格,PascalCase风格,以及 4 ** Google加‘k‘前缀的风格。 5 */ 6 static const int DAYS_IN_WEEK = 7; 7 static const int kDaysInWeek = 7; 8 9 enum FileOpenMode { 10 ReadOnly, WriteOnly, ReadWrite 11 }; 12 13 enum FileOpenMode { 14 READ_ONLY, WRITE_ONLY, READ_WRITE 15 };
tip.1:如果可以使用c++11特性,推荐enum class,否则可以在有歧义的枚举值中重复枚举类型的名字;
1 /* 宏命名推荐使用全字母大写加‘_‘分隔的风格 */ 2 #define OS_UNIX 3 #define OS_LINUX 4 #define OS_WINNT 5 6 /* 除非你想用条件编译将某些功能变为可选项 */ 7 #ifdef USE_TCMALLOC 8 #define my_malloc tcmalloc 9 #else 10 #define my_malloc malloc 11 #endif
tip.1:能用常量替代宏的地方尽量使用常量吧;
[逼死强迫症 - C&C++设计风格选择.1] : 命名规范
原文:http://www.cnblogs.com/far-taurus/p/5255011.html