Linux编码规范详解,linux编码详解


编码风格

1. 命名规则:

类名 大写C开头,其后每个单词首字母大写,单词之间不加任何分隔符 CRenderComponent

结构名 大写S开头,其余规则同类名 SRectangle

枚举名 大写E开头,其余规则同类名 ENodeType

类的公有函数 第一个单词首字母小写,且必须为动词,其后每个单词首字母大写,单词之间不加任何分隔符 initNetwork()

类的保护函数 以单下划线开头,其余规则同公有函数 _initNetwork()

类的私有函数 以双下划线开头,其余规则同公有函数 __initNetwork()

类的虚函数 在函数名末尾添加大写字母V _initNetworkV()

普通变量 每个单词首字母大写,且单词之间不加任何分隔符,整体变量名必须为名词 LocalIP

指针变量 以小写字母p开头,其余规则同普通变量 pData

类的成员变量 以m_开头,其余规则同普通变量 m_LocalIP

类的指针成员变量 以m_开头,其余规则同普通指针变量 m_pData

函数输入参数 以小写字母v开头,不区分输入参数是否为指针,其余规则同普通变量 vLocalIP,vData

函数输出参数 以小写字母vo开头,其余规则同函数输入参数 voLocalIP

函数输入出参数 某个参数同时作为输入和输出参数,则以小写字母vio开头,其他规则同函数输入参数 vioLocalIP

指针类型的函数参数 不需要在参数前加小写字母p

2. 多余的空格

(1)引用符号和变量名称之间不要加空格

(2)分号前不要加空格;

(3)”(“后不要加空格

3. 缺少的空格

(1) 函数的参数之间要加空格

(2) if等关键字后面要加空格

4.cpp文件中每个函数前加如下两行(类的构造函数和析构函数不加)

//******************************************************************

//FUNCTION:

5. 函数之间用且仅用一行空行分开;

6. 函数体内执行不同子功能的代码用且仅用一行空行分开;

7. 文件中任何地方不能出现连续两个或两个以上的空行;

8. 文件中不能有被注释掉的代码;

9. 避免为变量名增加注释去说明该变量的功能,变量名本身就该明确体现其功能;

10. 避免使用全局变量,绝对不能在全局命名空间中使用全局变量;

11. 尽量避免写注释,如果要写,尽量用英文,并注意拼写错误;

12. 避免变量和函数命名中的拼写错误;

13. 禁止在变量和函数命名中使用拼音;

14. 双重循环使用循环变量i和k,而不是i和j

15. 一个函数只完成一个功能,函数函数控制在50行;

16. 一个类的源代码行数控制在400行;

17. 变量的定义尽量靠近其第一次使用;

18. 对于重复出现的相同计算,应该用一个变量来保存计算结果,而不是多次重复计算

19. 避免在程序中直接出现数字; Magic Number;

20. 避免include无用的头文件,特别是在头文件中。请逐个删除头文件和cpp文件中的include语句,以测试哪些是无用的include;

21. 重载的虚函数必须使用关键字override进行修饰;

22. get*()成员函数的返回类型不能为void;

23. get*()成员函数的参数中不能包含输出参数;

24. get*()成员函数必须加const修饰,限制其不能修改所有成员变量;

25. get*()成员函数的返回值如果有必要,必须加const修饰以防止被修改;

26. 如果需要获取某个成员变量并对其进行修改,使用fetch*()而不是get*();

27. 如果需要通过输出参数的方式来获取某个成员变量,使用dump*()而不是get*();

28. 避免串联式的指针调用(如pClass1->getClass2()->getClass3()->doSomething());

29. 尽量使用了_ASSERT();

30. 工程中不能出现明显不应该的依赖关系。例如,如果我是做KNN搜索,那这个明显不该依赖OpenCV,OSG等这类特殊功能的函数库,但KNN依赖于EIGEN这类数学库或者boost这类通用库可以接受。

相关内容