关于C 编码规范的讨论之编码风格

关于C+编码规范的讨论之编码风格为什么？对语言充分利用语言特性充分利用语言特性对人可读性可读性可维护性可维护性复用性复用性一 编码格式命名原则代码格式注释文件和目录头文件条件编译编译命名原则清楚，无歧义简单，易于理解类型名 每个英文单词头字母大写，其他小写，以_T结尾变量和函数名 首字母小写，其后单词第一个字母大写，其余小写宏，常量和模板名 全大写，以下划线分割单词命名规则类和对象应是名词实现行为的函数应是动词变量名应是名词布尔型的名字要直观命名原则尽量使用可发音的名字避免使用于国际组织占用格式比如双下划线开头（比如双下划线开头（ISO cISO c，ANSI cANSI c），包），包含双下划线，单下划线开头，含双下划线，单下划线开头，isa-zisa-z 开头，开头，stra-zstra-z 开头，开头，mema-zmema-z 开头开头减少全局命名空间级标志符，置于命名空间、类或函数代码格式统一，合理，美观水平缩进每次用两个空格在“；”，“，”之后加空格在关键字和“（”之间加空格下列除外：下列除外：catchcatch，sizeofsizeof，typeidtypeid，asmasm除外除外代码格式文件主要部分用空行分开（分段可读）局部变量声明和代码之间用空行分开每行不超过78个字符，超过按逻辑分割花括号要单独占一行花括号中没有语句或单一语句不省略代码格式变量定义集中放置，各占一行变量定义集中放置，各占一行定义指针和引用时定义指针和引用时*和和&紧跟类型紧跟类型按编译器解析顺序放置变量声明的修饰性按编译器解析顺序放置变量声明的修饰性const char*const char*pNamepName和和char const*char const*pNamepName函数声明放在一行函数声明放在一行函数实现放于多行，依次是函数实现放于多行，依次是模板描述，模板描述，inlineinline和返回类型，函数名及参数，函数体和返回类型，函数名及参数，函数体函数名和左括号间不用空格函数名和左括号间不用空格函数声明时给出参数名字函数声明时给出参数名字代码格式类内不同级别的元素排列顺序按元素的公开性，由大到小排列按元素的公开性，由大到小排列publicpublic到到privateprivate类成员函数排列，按功能归类排列类成员变量按字母顺序排列（建议）注释用英文写确保注释完善代码，而非重复代码注释中的术语要通用注释简单，清楚，精确注释不能超出注释代码所含内容确保注释更新注释注释不具备约束使用者行为的能力注释不要嵌套不要用/*/注释掉大块代码，应该用#if 0函数注释，在声明和实现前给出恰当的注释注释频率，每5行至少有一行注释文件和目录使用统一且通用的文件名后缀文件名，体现内容，精练，可使用公共前缀类的文件组成，接口文件和实现文件保持文件前言的简洁性文件的段落安排有序头文件头文件多次引用的防范确保公共头文件的自足性引用时不要用绝对路径将函数库放在一个单独的目录下引用不要在头文件中定义常量、变量任何声明若被多个源文件引用则应在头文件中条件编译最小化条件编译的使用范围不要遗漏else若只测试符号的存在，不要赋值编译关注编译时的警告（warning）减少编译时间