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类的模拟实现)

C++中的assert

C++初阶第十一篇——list(list常见接口的用法与介绍+list的模拟实现+list迭代器原理)

C++ 中命名空间的 5 个常见用法

(C++)变长数组vector的常见用法