簡述

該參考是基于Doxygen注釋規范進行簡單歸納，可以適當根據自己的需求進行約定。

Doxygen可以從一套歸檔源文件開始，生成HTML格式的在線類瀏覽器，或離線的LATEX、RTF參考手冊。簡單來說就是一個程序的文件產生工具，可將程序中的特定注釋轉換成為說明文件。

注釋規范內容

1. 簡單注釋

(1) 單行注釋

///

(2) 多行注釋

/**

2. 文件注釋

/***@file?????文件名*@brief????簡介*@datails??細節*@mainpage 工程概覽*@autor????作者*@email????郵箱*@version??版本號*@date?????年-月-日*@license??版權*/

3. 常量/變量注釋

(1)代碼前注釋

///注釋

變量/常量定義

(2)代碼后注釋

變量/常量定義 ///

4. 函數注釋

下面是函數的詳細注釋，可根據實際情況增減相關條目。

/***@brief?????函數簡介*@datail ???詳細說明**@param ????形參 參數說明*@param ????形參 參數說明*@return????返回說明*@retval????返回值說明*@note??????注解*@attention?注意*@warning ??警告*@exception異常*/

5. 其他內容注釋

命令 生成字段名 說明

@see 參考

@class 應用類 用于文檔生成連接

@var 引用變量 用于文檔生成連接

@enum 引用枚舉 用于文檔生成連接

@code 代碼塊開始 與@endcode成對使用

@endcode 代碼塊接收 與@code成對使用

@bug 缺陷

@todo

@example 使用例子說明

@remarks 備注說明

@pre 函數前置條件

@deprecated 函數過時說明

總結

以上是生活随笔為你收集整理的c++ doxygen 注释规范_C语言代码注释参考的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。