C++注释的常见用法
Posted 休息休息接着来
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了C++注释的常见用法相关的知识,希望对你有一定的参考价值。
C++注释的常见用法
本文参考:https://www.cnblogs.com/aspir...
1. 基本用法
单行注释: //
//
多行注释: / ..... /
/* */
2. 几种常见的注释规范
文件头的标注
/** * @file Example.h * * @brief 对文件的简述 * * Details. * * * * @author XX.xx * * @email example@126.com * * @version 1.2.3.1(版本号) * * @date example@126.com * * @license GNU General Public License (GPL) * */
命名空间的标注
/** * @brief 命名空间的简单概述 \\n(换行) * 命名空间的详细概述 */ namespace example { }
类的标注
/** * @brief 类的简单概述 \\n(换行) * 类的详细概述 */ class example { };
函数的标注
/** * @brief 函数简要说明-测试函数 * @param index 参数1 * @param t 参数2 @see CTest * * @return 返回说明 * -<em>false</em> fail * -<em>true</em> succeed */ bool example(int index, const CTest& t);
以上是关于C++注释的常见用法的主要内容,如果未能解决你的问题,请参考以下文章
C++初阶第十篇——vector(vector常见接口的用法与介绍+vector的模拟实现)
C++初阶第九篇——string类(string类中一些常见接口的用法与介绍+string类的模拟实现)