C++格式要求

1. 头文件
1.1. Self-contained 头文件
头文件以.h结尾
用来插入文本的文件以.inc结尾(作为文本插入到代码某处)+(或者,文件内容实际上是其它头文件的特定平台(platform-specific)扩展部)

1.4. 内联函数
只有当函数只有 10 行甚至更少时才将其定义为内联函数

1.5. #include 的路径及顺序
项目内头文件应按照项目源代码目录树结构排列如:google-awesome-project/src/base/logging.h
1,dir2/foo2.h (优先位置, 详情如下)
2,C 系统文件
3,C++ 系统文件
4,其他库的 .h 文件
5,本项目内 .h 文件

2.4. 局部变量
将函数变量尽可能置于最小作用域内, 并在变量声明时进行初始化.

3.4结构体和类
仅当只有数据成员是使用struct,其他一概使用class
struct:一般只用来定义数成员
class:需要更多的函数功能

3.5 继承
使用继承的话一般使用public继承
继承的应用场景:1,实现继承 2,子类仅仅继承父类的方法名

3.6 多重继承
最多只有一个基类是非抽象类,其它基类都是以Interface为后缀的纯接口类

3.7 接口
接口类不能被直接实例化,因为他声名了纯虚构函数

3.8运算法符重载
只有在意义明显,不会出现奇怪的行为并且与对应的内建运算符的行为一致时才定义重载运算符。

3.9存取控制
3.10声明顺序
public protected private

4.函数
4.3引用参数
函数需要修改变量的值,参数必须为指针也可以声名为引用参数(C++中就是用引用)
函数参数列表中,所有引用参数都必须是const

4.5缺省参数
4.6函数返回类型后置语法
auto foo(int x)->int

7,命名约定
7.1函数命名,。比变量命名,文件命名要有描述性,少用缩写
7.2文件命名
文件命名要全部小写,可以加_
定义类是文件名一般成对出现.h  .cc
7.3类型命名
首写字母大写且不包括下划线,就是都是相连在一起的。
类型:类,结构体,类型定义,类型模板参数,枚举
7.4变量命名
变量和数据成员一律用小写,单词之间用下划线链接,类的成员变量一下划线结尾,当时结构体的就不用
7.5常数命名
被声名为constpr和const的变量,命名以k开头并且以k结尾,单词开头是以大写字母开头的
7.6函数命名
以大写字母开头且没有下划线
7.7命名空间
不适用缩写作为命名空间,使用文件名以使得内部名称独一无二
7.8 枚举
命名规则和常量和宏一样都是以k开头和以k结尾,首写字母是以大写字母开头的
7.9宏
全部的字母都是大写,并且是以下划线链接
8.注释
注释的目的是增加代码的可读性
8.1我的注释风格用//
8.2文件注释
每个概念的纤细文档应当放在各个概念中
注:不要再.h和.cc中复制注释
8.3类注释
每个类都要附带一份注释,用来描述类的功能和用法
8.4函数注释
函数声明处的注释描述函数的功能,定义处的注释描述函数的实现
8.5变量注释
如果变量名不能说明他的功能,就给变量加上注释
8.6实现注释
在实现的代码中加上一些注释比较好
我提供的注释应当解释代码,为什么要这么做和代码的目的,或者最好是让代码自文档化
总:注释因该做到言简意赅,不拖泥带水
TODO注释确实是为了标记一些未完成的或者完成不尽人意的地方


9.格式
9.1每一行的代码都不要超过80

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值