编码规范
来源:互联网 发布:淘宝详情尺寸大小 编辑:程序博客网 时间:2024/05/17 02:33
编码规范
2、对于.h头文件
一、无论是系统自动生成的文件还是自己手动生成的头文件,文件开头添加注释该问文件的主要的功能,添加自定义函数要说明该函数的主要功能,成员变量也是要说明该变量的作用以及默认值和在何种地方的会进行调用。
/**
* 用一行来描述类
*
*#include "XX.h" <BR>
*-llib
*
* 类的详细说明
*
* @seesomething
*/
#ifndef $FILE_BASE_UPPER$_H
#define $FILE_BASE_UPPER$_H
// 在这里包含系统头文件
//
// 在这里包含项目头文件
//
// 在这里包含局部头文件
//
// 在这里放置前置引用
//
class $ClassName$
{
public:
// 类的生命周期控制函数,如构造和析构,以及状态机
/**
*Default constructor.
*/
$ClassName$(void);
/**
*Copy constructor.
*
*@param from The value tocopy to this object.
*/
$ClassName$(const $ClassName$& from);
/**
*Destructor.
*/
virtual ~$ClassName$(void);
// 在这里放置类的运算操作符
/**
*Assignment operator.
*
*@param from THe value toassign to this object.
*
*@return A reference to thisobject.
*/
XX& operator=($ClassName$&from);
// 在这里放置类的操作
// 在这里放置属性存取
// 在这里放置类的状态查询
protected:
private:
};
// 内联方法定义
//
// 外部引用
//
#endif //$FILE_BASE_UPPER$_H
Doxygen - Class Comment
/*!
* \class $classname$
*
* \brief $end$
*
* \author %USERNAME%
* \date $MONTHLONGNAME$ $YEAR$
*/
Doxygen - Class Comment (Long)
/*!
* \class $classname$
*
* \ingroup GroupName
*
* \brief $end$
*
* TODO: long description
*
* \note
*
* \author %USERNAME%
*
* \version 1.0
*
* \date $MONTHLONGNAME$ $YEAR$
*
* Contact: user@company.com
*
*/
Doxygen - Header Comment
/*!
* \file $FILE_BASE$.$FILE_EXT$
*
* \author %USERNAME%
* \date $MONTHLONGNAME$ $YEAR$
*
* $end$
*/
Doxygen - Header Comment (Long)
/*!
* \file $FILE_BASE$.$FILE_EXT$
* \date $DATE$ $HOUR$:$MINUTE$
*
* \author %USERNAME%
* Contact: user@company.com
*
* \brief $end$
*
* TODO: long description
*
* \note
*/
3、.cpp文件
一、说明文件有头文件声明,具体有哪些方法,大概的功能是什么。
二、对应每个函数的功能逻辑,参数 返回值;
//************************************
// Method: ~CCpuIndexView
// FullName: CCpuIndexView::~CCpuIndexView
// Access: virtual protected
// Returns:
// Qualifier:
//************************************
三、函数功能的内部的主要分支和主要逻辑注释。
//
- 编码规范
- 规范编码
- 编码规范
- 编码规范
- 编码规范
- 编码规范
- 编码规范
- 编码规范
- 编码规范
- 编码规范
- 编码规范
- 编码规范
- 编码规范
- 编码规范
- 编码规范
- 编码规范
- 编码规范
- 编码规范
- 谈谈在Tyepscript(version:2.2.2)扩展(extends)built-in类型(e.g. Array)的问题
- 为什么说要搞定微服务架构,先搞定RPC框架?
- Hibernate映射——一对多关联映射(七)
- 基于边缘的图像分割——分水岭算法(watershed)算法分析(附opencv源码分析)
- Ionic2+Angular2创建项目打包Android及集成极光推送全解析排坑
- 编码规范
- POJ 1002 487-3279 G++
- jQuery:load()方法
- Two sum算法
- android.support.design.widget.TabLayout属性讲解
- 在服务器上搭建hexo博客
- Serialize and Deserialize BST
- TSQL生成数据导出SQL
- C++调用有道词典API实现Caesar密码的加密解密